@eventcatalog/sdk 2.15.1 → 2.17.0

package/dist/index.js

@@ -33,7 +33,7 @@ __export(src_exports, {
   default: () => src_default
 });
 module.exports = __toCommonJS(src_exports);
-var import_node_path20 = require("path");
+var import_node_path22 = require("path");
 
 // src/dsl/utils.ts
 var import_glob = require("glob");
@@ -828,8 +828,8 @@ var getFiles = async (pattern, ignore = "") => {
     );
   }
 };
-var readMdxFile = async (path6) => {
-  const { data } = import_gray_matter.default.read(path6);
+var readMdxFile = async (path8) => {
+  const { data } = import_gray_matter.default.read(path8);
   const { markdown, ...frontmatter } = data;
   return { ...frontmatter, markdown };
 };
@@ -923,8 +923,8 @@ var writeResource = async (catalogDir, resource, options = {
   versionExistingContent: false,
   format: "mdx"
 }) => {
-  const path6 = options.path || `/${resource.id}`;
-  const fullPath = (0, import_path.join)(catalogDir, path6);
+  const path8 = options.path || `/${resource.id}`;
+  const fullPath = (0, import_path.join)(catalogDir, path8);
   const format = options.format || "mdx";
   import_node_fs2.default.mkdirSync(fullPath, { recursive: true });
   const lockPath = (0, import_path.join)(fullPath, `index.${format}`);
@@ -1058,16 +1058,16 @@ var rmResourceById = async (catalogDir, id, version, options) => {
   }
   invalidateFileCache();
 };
-var waitForFileRemoval = async (path6, maxRetries = 50, delay = 10) => {
+var waitForFileRemoval = async (path8, maxRetries = 50, delay = 10) => {
   for (let i = 0; i < maxRetries; i++) {
     try {
-      await import_promises.default.access(path6);
+      await import_promises.default.access(path8);
       await new Promise((resolve2) => setTimeout(resolve2, delay));
     } catch (error) {
       return;
     }
   }
-  throw new Error(`File/directory ${path6} was not removed after ${maxRetries} attempts`);
+  throw new Error(`File/directory ${path8} was not removed after ${maxRetries} attempts`);
 };
 var addFileToResource = async (catalogDir, id, file, version, options) => {
   let pathToResource;
@@ -1120,8 +1120,8 @@ var writeEventToService = (directory) => async (event, service, options = { path
   pathForEvent = (0, import_node_path4.join)(pathForEvent, event.id);
   await writeResource(directory, { ...event }, { ...options, path: pathForEvent, type: "event" });
 };
-var rmEvent = (directory) => async (path6) => {
-  await import_promises2.default.rm((0, import_node_path4.join)(directory, path6), { recursive: true });
+var rmEvent = (directory) => async (path8) => {
+  await import_promises2.default.rm((0, import_node_path4.join)(directory, path8), { recursive: true });
   invalidateFileCache();
 };
 var rmEventById = (directory) => async (id, version, persistFiles) => {
@@ -1157,8 +1157,8 @@ var writeCommandToService = (directory) => async (command, service, options = {
   pathForCommand = (0, import_node_path5.join)(pathForCommand, command.id);
   await writeResource(directory, { ...command }, { ...options, path: pathForCommand, type: "command" });
 };
-var rmCommand = (directory) => async (path6) => {
-  await import_promises3.default.rm((0, import_node_path5.join)(directory, path6), { recursive: true });
+var rmCommand = (directory) => async (path8) => {
+  await import_promises3.default.rm((0, import_node_path5.join)(directory, path8), { recursive: true });
   invalidateFileCache();
 };
 var rmCommandById = (directory) => async (id, version, persistFiles) => rmResourceById(directory, id, version, { type: "command", persistFiles });
@@ -1192,8 +1192,8 @@ var writeQueryToService = (directory) => async (query, service, options = { path
   pathForQuery = (0, import_node_path6.join)(pathForQuery, query.id);
   await writeResource(directory, { ...query }, { ...options, path: pathForQuery, type: "query" });
 };
-var rmQuery = (directory) => async (path6) => {
-  await import_promises4.default.rm((0, import_node_path6.join)(directory, path6), { recursive: true });
+var rmQuery = (directory) => async (path8) => {
+  await import_promises4.default.rm((0, import_node_path6.join)(directory, path8), { recursive: true });
   invalidateFileCache();
 };
 var rmQueryById = (directory) => async (id, version, persistFiles) => {
@@ -1213,8 +1213,8 @@ var queryHasVersion = (directory) => async (id, version) => {
 var import_promises5 = __toESM(require("fs/promises"));
 var import_node_path7 = require("path");
 var getService = (directory) => async (id, version) => getResource(directory, id, version, { type: "service" });
-var getServiceByPath = (directory) => async (path6) => {
-  const service = await getResource(directory, void 0, void 0, { type: "service" }, path6);
+var getServiceByPath = (directory) => async (path8) => {
+  const service = await getResource(directory, void 0, void 0, { type: "service" }, path8);
   return service;
 };
 var getServices = (directory) => async (options) => getResources(directory, {
@@ -1249,8 +1249,8 @@ var writeService = (directory) => async (service, options = {
 };
 var writeVersionedService = (directory) => async (service) => {
   const resource = { ...service };
-  const path6 = getVersionedDirectory(service.id, service.version);
-  return await writeService(directory)(resource, { path: path6 });
+  const path8 = getVersionedDirectory(service.id, service.version);
+  return await writeService(directory)(resource, { path: path8 });
 };
 var writeServiceToDomain = (directory) => async (service, domain, options = { path: "", format: "mdx", override: false }) => {
   let pathForService = domain.version && domain.version !== "latest" ? `/${domain.id}/versioned/${domain.version}/services` : `/${domain.id}/services`;
@@ -1258,8 +1258,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 (path6) => {
-  await import_promises5.default.rm((0, import_node_path7.join)(directory, path6), { recursive: true });
+var rmService = (directory) => async (path8) => {
+  await import_promises5.default.rm((0, import_node_path7.join)(directory, path8), { recursive: true });
   invalidateFileCache();
 };
 var rmServiceById = (directory) => async (id, version, persistFiles) => {
@@ -1324,8 +1324,8 @@ var addMessageToService = (directory) => async (id, direction, event, version) =
   if (!existingResource) {
     throw new Error(`Cannot find service ${id} in the catalog`);
   }
-  const path6 = existingResource.split(/[\\/]+services/)[0];
-  const pathToResource = (0, import_node_path7.join)(path6, "services");
+  const path8 = existingResource.split(/[\\/]+services/)[0];
+  const pathToResource = (0, import_node_path7.join)(path8, "services");
   await rmServiceById(directory)(id, version);
   await writeService(pathToResource)(service, { format: extension === ".md" ? "md" : "mdx" });
 };
@@ -1333,9 +1333,9 @@ var serviceHasVersion = (directory) => async (id, version) => {
   const file = await findFileById(directory, id, version);
   return !!file;
 };
-var isService = (directory) => async (path6) => {
-  const service = await getServiceByPath(directory)(path6);
-  const relativePath = (0, import_node_path7.relative)(directory, path6);
+var isService = (directory) => async (path8) => {
+  const service = await getServiceByPath(directory)(path8);
+  const relativePath = (0, import_node_path7.relative)(directory, path8);
   const segments = relativePath.split(/[/\\]+/);
   return !!service && segments.includes("services");
 };
@@ -1357,8 +1357,8 @@ var addEntityToService = (directory) => async (id, entity, version) => {
   if (!existingResource) {
     throw new Error(`Cannot find service ${id} in the catalog`);
   }
-  const path6 = existingResource.split(/[\\/]+services/)[0];
-  const pathToResource = (0, import_node_path7.join)(path6, "services");
+  const path8 = existingResource.split(/[\\/]+services/)[0];
+  const pathToResource = (0, import_node_path7.join)(path8, "services");
   await rmServiceById(directory)(id, version);
   await writeService(pathToResource)(service, { format: extension === ".md" ? "md" : "mdx" });
 };
@@ -1393,8 +1393,8 @@ var addDataStoreToService = (directory) => async (id, operation, dataStore, vers
   if (!existingResource) {
     throw new Error(`Cannot find service ${id} in the catalog`);
   }
-  const path6 = existingResource.split(/[\\/]+services/)[0];
-  const pathToResource = (0, import_node_path7.join)(path6, "services");
+  const path8 = existingResource.split(/[\\/]+services/)[0];
+  const pathToResource = (0, import_node_path7.join)(path8, "services");
   await rmServiceById(directory)(id, version);
   await writeService(pathToResource)(service, { format: extension === ".md" ? "md" : "mdx" });
 };
@@ -1435,8 +1435,8 @@ var writeDomain = (directory) => async (domain, options = {
   return await writeResource(directory, resource, { ...options, type: "domain" });
 };
 var versionDomain = (directory) => async (id) => versionResource(directory, id);
-var rmDomain = (directory) => async (path6) => {
-  await import_promises6.default.rm((0, import_node_path8.join)(directory, path6), { recursive: true });
+var rmDomain = (directory) => async (path8) => {
+  await import_promises6.default.rm((0, import_node_path8.join)(directory, path8), { recursive: true });
   invalidateFileCache();
 };
 var rmDomainById = (directory) => async (id, version, persistFiles) => rmResourceById(directory, id, version, { type: "domain", persistFiles });
@@ -1567,8 +1567,8 @@ var import_node_path9 = require("path");
 var getChannel = (directory) => async (id, version) => getResource(directory, id, version, { type: "channel" });
 var getChannels = (directory) => async (options) => getResources(directory, { type: "channels", ...options });
 var writeChannel = (directory) => async (channel, options = { path: "" }) => writeResource(directory, { ...channel }, { ...options, type: "channel" });
-var rmChannel = (directory) => async (path6) => {
-  await import_promises7.default.rm((0, import_node_path9.join)(directory, path6), { recursive: true });
+var rmChannel = (directory) => async (path8) => {
+  await import_promises7.default.rm((0, import_node_path9.join)(directory, path8), { recursive: true });
   invalidateFileCache();
 };
 var rmChannelById = (directory) => async (id, version, persistFiles) => rmResourceById(directory, id, version, { type: "channel", persistFiles });
@@ -1610,8 +1610,8 @@ var addMessageToChannel = (directory, collection) => async (id, _message, versio
   if (!existingResource) {
     throw new Error(`Cannot find message ${id} in the catalog`);
   }
-  const path6 = existingResource.split(`/[\\/]+${collection}`)[0];
-  const pathToResource = (0, import_node_path9.join)(path6, collection);
+  const path8 = existingResource.split(`/[\\/]+${collection}`)[0];
+  const pathToResource = (0, import_node_path9.join)(path8, collection);
   await rmMessageById(directory)(_message.id, _message.version, true);
   await writeMessage(pathToResource)(message, { format: extension === ".md" ? "md" : "mdx" });
 };
@@ -1620,8 +1620,8 @@ var addMessageToChannel = (directory, collection) => async (id, _message, versio
 var import_node_path10 = require("path");
 var import_gray_matter4 = __toESM(require("gray-matter"));
 var import_semver5 = require("semver");
-var getMessageBySchemaPath = (directory) => async (path6, options) => {
-  const pathToMessage = (0, import_node_path10.dirname)(path6);
+var getMessageBySchemaPath = (directory) => async (path8, options) => {
+  const pathToMessage = (0, import_node_path10.dirname)(path8);
   try {
     const files = await getFiles(`${directory}/${pathToMessage}/index.{md,mdx}`);
     if (!files || files.length === 0) {
@@ -1693,18 +1693,18 @@ var getProducersAndConsumersForMessage = (directory) => async (id, version, opti
   }
   return { producers, consumers };
 };
-var getConsumersOfSchema = (directory) => async (path6) => {
+var getConsumersOfSchema = (directory) => async (path8) => {
   try {
-    const message = await getMessageBySchemaPath(directory)(path6);
+    const message = await getMessageBySchemaPath(directory)(path8);
     const { consumers } = await getProducersAndConsumersForMessage(directory)(message.id, message.version);
     return consumers;
   } catch (error) {
     return [];
   }
 };
-var getProducersOfSchema = (directory) => async (path6) => {
+var getProducersOfSchema = (directory) => async (path8) => {
   try {
-    const message = await getMessageBySchemaPath(directory)(path6);
+    const message = await getMessageBySchemaPath(directory)(path8);
     const { producers } = await getProducersAndConsumersForMessage(directory)(message.id, message.version);
     return producers;
   } catch (error) {
@@ -1908,8 +1908,8 @@ var filterCollection = (collection, options) => {
 };
 var getEventCatalogConfigurationFile = (directory) => async () => {
   try {
-    const path6 = (0, import_node_path15.join)(directory, "eventcatalog.config.js");
-    const configModule = await import(path6);
+    const path8 = (0, import_node_path15.join)(directory, "eventcatalog.config.js");
+    const configModule = await import(path8);
     return configModule.default;
   } catch (error) {
     console.error("Error getting event catalog configuration file", error);
@@ -1965,9 +1965,408 @@ var dumpCatalog = (directory) => async (options) => {
   };
 };
 
-// src/entities.ts
+// src/snapshots.ts
+var import_node_fs7 = __toESM(require("fs"));
+var import_node_path16 = __toESM(require("path"));
+var import_node_child_process = require("child_process");
+var import_semver6 = require("semver");
+
+// src/snapshot-diff.ts
+var stableStringify = (value) => {
+  if (value === null || value === void 0 || typeof value !== "object") {
+    return JSON.stringify(value);
+  }
+  if (Array.isArray(value)) {
+    return "[" + value.map(stableStringify).join(",") + "]";
+  }
+  const sorted = Object.keys(value).sort().map((key) => JSON.stringify(key) + ":" + stableStringify(value[key]));
+  return "{" + sorted.join(",") + "}";
+};
+var flattenResources = (snapshot) => {
+  const resources = [];
+  const addResources = (items, type) => {
+    for (const item of items) {
+      resources.push({
+        resourceId: item.id,
+        version: item.version,
+        type,
+        data: item
+      });
+    }
+  };
+  addResources(snapshot.resources.domains, "domain");
+  addResources(snapshot.resources.services, "service");
+  addResources(snapshot.resources.messages.events, "event");
+  addResources(snapshot.resources.messages.commands, "command");
+  addResources(snapshot.resources.messages.queries, "query");
+  addResources(snapshot.resources.channels, "channel");
+  return resources;
+};
+var EXCLUDED_FIELDS = /* @__PURE__ */ new Set(["markdown", "_eventcatalog"]);
+var getComparableFields = (data) => {
+  const result = {};
+  for (const [key, value] of Object.entries(data)) {
+    if (!EXCLUDED_FIELDS.has(key)) {
+      result[key] = value;
+    }
+  }
+  return result;
+};
+var findChangedFields = (dataA, dataB) => {
+  const fieldsA = getComparableFields(dataA);
+  const fieldsB = getComparableFields(dataB);
+  const allKeys = /* @__PURE__ */ new Set([...Object.keys(fieldsA), ...Object.keys(fieldsB)]);
+  const changed = [];
+  for (const key of allKeys) {
+    if (stableStringify(fieldsA[key] ?? null) !== stableStringify(fieldsB[key] ?? null)) {
+      changed.push(key);
+    }
+  }
+  return changed;
+};
+var resourceKey = (r) => `${r.resourceId}@${r.version}`;
+var idTypeKey = (r) => `${r.resourceId}:${r.type}`;
+var computeResourceDiff = (snapshotA, snapshotB) => {
+  const resourcesA = flattenResources(snapshotA);
+  const resourcesB = flattenResources(snapshotB);
+  const mapA = /* @__PURE__ */ new Map();
+  const byIdA = /* @__PURE__ */ new Map();
+  for (const r of resourcesA) {
+    mapA.set(resourceKey(r), r);
+    byIdA.set(idTypeKey(r), r);
+  }
+  const mapB = /* @__PURE__ */ new Map();
+  const byIdB = /* @__PURE__ */ new Map();
+  for (const r of resourcesB) {
+    mapB.set(resourceKey(r), r);
+    byIdB.set(idTypeKey(r), r);
+  }
+  const changes = [];
+  const handledIds = /* @__PURE__ */ new Set();
+  for (const resource of resourcesB) {
+    const key = resourceKey(resource);
+    if (!mapA.has(key)) {
+      const idKey = idTypeKey(resource);
+      const oldResource = byIdA.get(idKey);
+      if (oldResource && oldResource.version !== resource.version && !handledIds.has(idKey)) {
+        const changedFields = findChangedFields(oldResource.data, resource.data);
+        changes.push({
+          resourceId: resource.resourceId,
+          version: resource.version,
+          type: resource.type,
+          changeType: "versioned",
+          previousVersion: oldResource.version,
+          newVersion: resource.version,
+          changedFields: changedFields.length > 0 ? changedFields : void 0
+        });
+        handledIds.add(idKey);
+      } else if (!handledIds.has(idKey)) {
+        changes.push({
+          resourceId: resource.resourceId,
+          version: resource.version,
+          type: resource.type,
+          changeType: "added"
+        });
+      }
+    }
+  }
+  for (const resource of resourcesA) {
+    const key = resourceKey(resource);
+    if (!mapB.has(key)) {
+      const idKey = idTypeKey(resource);
+      if (!handledIds.has(idKey)) {
+        changes.push({
+          resourceId: resource.resourceId,
+          version: resource.version,
+          type: resource.type,
+          changeType: "removed"
+        });
+      }
+    }
+  }
+  for (const resourceB of resourcesB) {
+    const key = resourceKey(resourceB);
+    const resourceA = mapA.get(key);
+    if (resourceA) {
+      const changedFields = findChangedFields(resourceA.data, resourceB.data);
+      if (changedFields.length > 0) {
+        changes.push({
+          resourceId: resourceB.resourceId,
+          version: resourceB.version,
+          type: resourceB.type,
+          changeType: "modified",
+          changedFields
+        });
+      }
+    }
+  }
+  return changes;
+};
+var getRelationshipKey = (serviceId, resourceId, resourceVersion, direction) => {
+  return `${serviceId}:${direction}:${resourceId}@${resourceVersion || "latest"}`;
+};
+var extractRelationships = (snapshot) => {
+  const relationships = /* @__PURE__ */ new Map();
+  for (const service of snapshot.resources.services) {
+    for (const direction of ["sends", "receives"]) {
+      const pointers = service[direction] || [];
+      for (const pointer of pointers) {
+        const key = getRelationshipKey(service.id, pointer.id, pointer.version, direction);
+        relationships.set(key, {
+          serviceId: service.id,
+          serviceVersion: service.version,
+          resourceId: pointer.id,
+          resourceVersion: pointer.version,
+          direction
+        });
+      }
+    }
+  }
+  return relationships;
+};
+var computeRelationshipDiff = (snapshotA, snapshotB) => {
+  const relsA = extractRelationships(snapshotA);
+  const relsB = extractRelationships(snapshotB);
+  const changes = [];
+  for (const [key, rel] of relsB) {
+    if (!relsA.has(key)) {
+      changes.push({ ...rel, changeType: "added" });
+    }
+  }
+  for (const [key, rel] of relsA) {
+    if (!relsB.has(key)) {
+      changes.push({ ...rel, changeType: "removed" });
+    }
+  }
+  return changes;
+};
+
+// src/snapshots.ts
+var SNAPSHOT_VERSION = "1.0.0";
+var getEventCatalogVersion2 = (catalogDir) => {
+  try {
+    const packageJson = import_node_fs7.default.readFileSync(import_node_path16.default.join(catalogDir, "package.json"), "utf8");
+    const packageJsonObject = JSON.parse(packageJson);
+    return packageJsonObject["dependencies"]?.["@eventcatalog/core"] ?? "unknown";
+  } catch {
+    return "unknown";
+  }
+};
+var pickCoreFields = (resource) => {
+  const picked = { id: resource.id, version: resource.version, name: resource.name };
+  if (resource.sends) picked.sends = resource.sends;
+  if (resource.receives) picked.receives = resource.receives;
+  if (resource.deprecated) picked.deprecated = resource.deprecated;
+  if (resource.owners) picked.owners = resource.owners;
+  return picked;
+};
+var deduplicateByLatestVersion = (resources) => {
+  const seen = /* @__PURE__ */ new Map();
+  for (const r of resources) {
+    const existing = seen.get(r.id);
+    if (!existing || (0, import_semver6.compare)(r.version, existing.version) > 0) {
+      seen.set(r.id, r);
+    }
+  }
+  return Array.from(seen.values());
+};
+var stripToCore = (resources) => {
+  if (!resources || resources.length === 0) return [];
+  return deduplicateByLatestVersion(resources).map(pickCoreFields);
+};
+var detectGitInfo = (catalogDir) => {
+  try {
+    const opts = { cwd: catalogDir, encoding: "utf8", stdio: "pipe" };
+    const branch = (0, import_node_child_process.execSync)("git rev-parse --abbrev-ref HEAD", opts).trim();
+    const commit = (0, import_node_child_process.execSync)("git rev-parse --short HEAD", opts).trim();
+    const status = (0, import_node_child_process.execSync)("git status --porcelain", opts).trim();
+    return { branch, commit, dirty: status.length > 0 };
+  } catch {
+    return void 0;
+  }
+};
+var createSnapshot = (directory) => {
+  return async (options) => {
+    const { label, outputDir, git } = options || {};
+    const sdk = src_default(directory);
+    const [domains, services, events, commands, queries, channels] = await Promise.all([
+      sdk.getDomains(),
+      sdk.getServices(),
+      sdk.getEvents(),
+      sdk.getCommands(),
+      sdk.getQueries(),
+      sdk.getChannels()
+    ]);
+    const snapshotDomains = stripToCore(domains);
+    const snapshotServices = stripToCore(services);
+    const snapshotEvents = stripToCore(events);
+    const snapshotCommands = stripToCore(commands);
+    const snapshotQueries = stripToCore(queries);
+    const snapshotChannels = stripToCore(channels);
+    const snapshotLabel = label || (/* @__PURE__ */ new Date()).toISOString().replace(/[:.]/g, "-");
+    const gitInfo = git || detectGitInfo(directory);
+    const snapshot = {
+      snapshotVersion: SNAPSHOT_VERSION,
+      catalogVersion: getEventCatalogVersion2(directory),
+      label: snapshotLabel,
+      createdAt: (/* @__PURE__ */ new Date()).toISOString(),
+      ...gitInfo ? { git: gitInfo } : {},
+      resources: {
+        domains: snapshotDomains,
+        services: snapshotServices,
+        messages: {
+          events: snapshotEvents,
+          commands: snapshotCommands,
+          queries: snapshotQueries
+        },
+        channels: snapshotChannels
+      }
+    };
+    const snapshotsDir = outputDir || import_node_path16.default.join(directory, ".snapshots");
+    import_node_fs7.default.mkdirSync(snapshotsDir, { recursive: true });
+    const fileName = `${snapshotLabel}.snapshot.json`;
+    const filePath = import_node_path16.default.join(snapshotsDir, fileName);
+    import_node_fs7.default.writeFileSync(filePath, JSON.stringify(snapshot));
+    return { filePath, snapshot };
+  };
+};
+var diffSnapshots = (directory) => async (snapshotAPath, snapshotBPath) => {
+  const snapshotA = JSON.parse(import_node_fs7.default.readFileSync(snapshotAPath, "utf-8"));
+  const snapshotB = JSON.parse(import_node_fs7.default.readFileSync(snapshotBPath, "utf-8"));
+  const resourceChanges = computeResourceDiff(snapshotA, snapshotB);
+  const relationshipChanges = computeRelationshipDiff(snapshotA, snapshotB);
+  const resourceCounts = { added: 0, removed: 0, modified: 0, versioned: 0 };
+  for (const r of resourceChanges) resourceCounts[r.changeType]++;
+  const relCounts = { added: 0, removed: 0 };
+  for (const r of relationshipChanges) relCounts[r.changeType]++;
+  return {
+    snapshotA: { label: snapshotA.label, createdAt: snapshotA.createdAt },
+    snapshotB: { label: snapshotB.label, createdAt: snapshotB.createdAt },
+    summary: {
+      totalChanges: resourceChanges.length + relationshipChanges.length,
+      resourcesAdded: resourceCounts.added,
+      resourcesRemoved: resourceCounts.removed,
+      resourcesModified: resourceCounts.modified,
+      resourcesVersioned: resourceCounts.versioned,
+      relationshipsAdded: relCounts.added,
+      relationshipsRemoved: relCounts.removed
+    },
+    resources: resourceChanges,
+    relationships: relationshipChanges
+  };
+};
+var listSnapshots = (directory) => async () => {
+  const snapshotsDir = import_node_path16.default.join(directory, ".snapshots");
+  if (!import_node_fs7.default.existsSync(snapshotsDir)) return [];
+  const files = import_node_fs7.default.readdirSync(snapshotsDir).filter((f) => f.endsWith(".snapshot.json"));
+  const snapshots = [];
+  for (const file of files) {
+    try {
+      const filePath = import_node_path16.default.join(snapshotsDir, file);
+      const content = JSON.parse(import_node_fs7.default.readFileSync(filePath, "utf-8"));
+      snapshots.push({
+        label: content.label,
+        createdAt: content.createdAt,
+        filePath,
+        ...content.git ? { git: content.git } : {}
+      });
+    } catch {
+    }
+  }
+  return snapshots.sort((a, b) => a.createdAt.localeCompare(b.createdAt));
+};
+
+// src/changelogs.ts
+var import_node_path17 = __toESM(require("path"));
+var import_node_fs8 = __toESM(require("fs"));
 var import_promises10 = __toESM(require("fs/promises"));
-var import_node_path16 = require("path");
+var import_gray_matter8 = __toESM(require("gray-matter"));
+var writeChangelog = (catalogDir) => async (id, changelog, options = {}) => {
+  const { version, format = "mdx" } = options;
+  const resourceFile = await findFileById(catalogDir, id, version);
+  if (!resourceFile) {
+    throw new Error(`No resource found with id: ${id}${version ? ` and version: ${version}` : ""}`);
+  }
+  const resourceDir = (0, import_node_path17.dirname)(resourceFile);
+  const changelogPath = import_node_path17.default.join(resourceDir, `changelog.${format}`);
+  const { markdown, ...frontmatter } = changelog;
+  const fm = { ...frontmatter };
+  if (fm.createdAt instanceof Date) {
+    fm.createdAt = fm.createdAt;
+  }
+  if (!fm.badges || fm.badges.length === 0) {
+    delete fm.badges;
+  }
+  import_node_fs8.default.mkdirSync(resourceDir, { recursive: true });
+  const document = import_gray_matter8.default.stringify(markdown.trim(), fm);
+  import_node_fs8.default.writeFileSync(changelogPath, document);
+  invalidateFileCache();
+};
+var appendChangelog = (catalogDir) => async (id, changelog, options = {}) => {
+  const { version, format = "mdx" } = options;
+  const resourceFile = await findFileById(catalogDir, id, version);
+  if (!resourceFile) {
+    throw new Error(`No resource found with id: ${id}${version ? ` and version: ${version}` : ""}`);
+  }
+  const resourceDir = (0, import_node_path17.dirname)(resourceFile);
+  const mdxPath = import_node_path17.default.join(resourceDir, "changelog.mdx");
+  const mdPath = import_node_path17.default.join(resourceDir, "changelog.md");
+  const existingPath = import_node_fs8.default.existsSync(mdxPath) ? mdxPath : import_node_fs8.default.existsSync(mdPath) ? mdPath : void 0;
+  if (!existingPath) {
+    return writeChangelog(catalogDir)(id, changelog, options);
+  }
+  const existing = import_gray_matter8.default.read(existingPath);
+  const existingContent = existing.content.trim();
+  const newEntry = changelog.markdown.trim();
+  const combined = `${newEntry}
+
+---
+
+${existingContent}`;
+  const fm = { ...existing.data };
+  fm.createdAt = changelog.createdAt;
+  if (changelog.badges && changelog.badges.length > 0) {
+    fm.badges = changelog.badges;
+  } else {
+    delete fm.badges;
+  }
+  const document = import_gray_matter8.default.stringify(combined, fm);
+  import_node_fs8.default.writeFileSync(existingPath, document);
+  invalidateFileCache();
+};
+var getChangelog = (catalogDir) => async (id, options = {}) => {
+  const { version } = options;
+  const resourceFile = await findFileById(catalogDir, id, version);
+  if (!resourceFile) return void 0;
+  const resourceDir = (0, import_node_path17.dirname)(resourceFile);
+  const mdxPath = import_node_path17.default.join(resourceDir, "changelog.mdx");
+  const mdPath = import_node_path17.default.join(resourceDir, "changelog.md");
+  const changelogPath = import_node_fs8.default.existsSync(mdxPath) ? mdxPath : import_node_fs8.default.existsSync(mdPath) ? mdPath : void 0;
+  if (!changelogPath) return void 0;
+  const { data, content } = import_gray_matter8.default.read(changelogPath);
+  return { ...data, markdown: content.trim() };
+};
+var rmChangelog = (catalogDir) => async (id, options = {}) => {
+  const { version } = options;
+  const resourceFile = await findFileById(catalogDir, id, version);
+  if (!resourceFile) {
+    throw new Error(`No resource found with id: ${id}${version ? ` and version: ${version}` : ""}`);
+  }
+  const resourceDir = (0, import_node_path17.dirname)(resourceFile);
+  const mdxPath = import_node_path17.default.join(resourceDir, "changelog.mdx");
+  const mdPath = import_node_path17.default.join(resourceDir, "changelog.md");
+  if (import_node_fs8.default.existsSync(mdxPath)) {
+    await import_promises10.default.rm(mdxPath);
+  }
+  if (import_node_fs8.default.existsSync(mdPath)) {
+    await import_promises10.default.rm(mdPath);
+  }
+  invalidateFileCache();
+};
+
+// src/entities.ts
+var import_promises11 = __toESM(require("fs/promises"));
+var import_node_path18 = require("path");
 var getEntity = (directory) => async (id, version) => getResource(directory, id, version, { type: "entity" });
 var getEntities = (directory) => async (options) => getResources(directory, { type: "entities", latestOnly: options?.latestOnly });
 var writeEntity = (directory) => async (entity, options = {
@@ -1975,8 +2374,8 @@ var writeEntity = (directory) => async (entity, options = {
   override: false,
   format: "mdx"
 }) => writeResource(directory, { ...entity }, { ...options, type: "entity" });
-var rmEntity = (directory) => async (path6) => {
-  await import_promises10.default.rm((0, import_node_path16.join)(directory, path6), { recursive: true });
+var rmEntity = (directory) => async (path8) => {
+  await import_promises11.default.rm((0, import_node_path18.join)(directory, path8), { recursive: true });
   invalidateFileCache();
 };
 var rmEntityById = (directory) => async (id, version, persistFiles) => {
@@ -1989,8 +2388,8 @@ var entityHasVersion = (directory) => async (id, version) => {
 };
 
 // src/containers.ts
-var import_promises11 = __toESM(require("fs/promises"));
-var import_node_path17 = require("path");
+var import_promises12 = __toESM(require("fs/promises"));
+var import_node_path19 = require("path");
 var getContainer = (directory) => async (id, version) => getResource(directory, id, version, { type: "container" });
 var getContainers = (directory) => async (options) => getResources(directory, { type: "containers", latestOnly: options?.latestOnly });
 var writeContainer = (directory) => async (data, options = {
@@ -1999,8 +2398,8 @@ var writeContainer = (directory) => async (data, options = {
   format: "mdx"
 }) => writeResource(directory, { ...data }, { ...options, type: "container" });
 var versionContainer = (directory) => async (id) => versionResource(directory, id);
-var rmContainer = (directory) => async (path6) => {
-  await import_promises11.default.rm((0, import_node_path17.join)(directory, path6), { recursive: true });
+var rmContainer = (directory) => async (path8) => {
+  await import_promises12.default.rm((0, import_node_path19.join)(directory, path8), { recursive: true });
   invalidateFileCache();
 };
 var rmContainerById = (directory) => async (id, version, persistFiles) => {
@@ -2017,7 +2416,7 @@ var writeContainerToService = (directory) => async (container, service, options
     throw new Error("Service not found");
   }
   let pathForContainer = service.version && service.version !== "latest" ? `${resourcePath.directory}/versioned/${service.version}/containers` : `${resourcePath.directory}/containers`;
-  pathForContainer = (0, import_node_path17.join)(pathForContainer, container.id);
+  pathForContainer = (0, import_node_path19.join)(pathForContainer, container.id);
   await writeResource(directory, { ...container }, { ...options, path: pathForContainer, type: "container" });
 };
 
@@ -2033,8 +2432,8 @@ var addFileToDataStore = addFileToContainer;
 var writeDataStoreToService = writeContainerToService;
 
 // src/data-products.ts
-var import_promises12 = __toESM(require("fs/promises"));
-var import_node_path18 = require("path");
+var import_promises13 = __toESM(require("fs/promises"));
+var import_node_path20 = require("path");
 var getDataProduct = (directory) => async (id, version) => getResource(directory, id, version, { type: "data-product" });
 var getDataProducts = (directory) => async (options) => getResources(directory, { type: "data-products", latestOnly: options?.latestOnly });
 var writeDataProduct = (directory) => async (dataProduct, options = {
@@ -2044,11 +2443,11 @@ var writeDataProduct = (directory) => async (dataProduct, options = {
 }) => writeResource(directory, { ...dataProduct }, { ...options, type: "data-product" });
 var writeDataProductToDomain = (directory) => async (dataProduct, domain, options = { path: "", format: "mdx", override: false }) => {
   let pathForDataProduct = domain.version && domain.version !== "latest" ? `/${domain.id}/versioned/${domain.version}/data-products` : `/${domain.id}/data-products`;
-  pathForDataProduct = (0, import_node_path18.join)(pathForDataProduct, dataProduct.id);
+  pathForDataProduct = (0, import_node_path20.join)(pathForDataProduct, dataProduct.id);
   await writeResource(directory, { ...dataProduct }, { ...options, path: pathForDataProduct, type: "data-product" });
 };
-var rmDataProduct = (directory) => async (path6) => {
-  await import_promises12.default.rm((0, import_node_path18.join)(directory, path6), { recursive: true });
+var rmDataProduct = (directory) => async (path8) => {
+  await import_promises13.default.rm((0, import_node_path20.join)(directory, path8), { recursive: true });
   invalidateFileCache();
 };
 var rmDataProductById = (directory) => async (id, version, persistFiles) => {
@@ -2062,8 +2461,8 @@ var dataProductHasVersion = (directory) => async (id, version) => {
 var addFileToDataProduct = (directory) => async (id, file, version) => addFileToResource(directory, id, file, version);
 
 // src/diagrams.ts
-var import_promises13 = __toESM(require("fs/promises"));
-var import_node_path19 = require("path");
+var import_promises14 = __toESM(require("fs/promises"));
+var import_node_path21 = require("path");
 var getDiagram = (directory) => async (id, version) => getResource(directory, id, version, { type: "diagram" });
 var getDiagrams = (directory) => async (options) => getResources(directory, { type: "diagrams", latestOnly: options?.latestOnly });
 var writeDiagram = (directory) => async (diagram, options = {
@@ -2071,8 +2470,8 @@ var writeDiagram = (directory) => async (diagram, options = {
   override: false,
   format: "mdx"
 }) => writeResource(directory, { ...diagram }, { ...options, type: "diagram" });
-var rmDiagram = (directory) => async (path6) => {
-  await import_promises13.default.rm((0, import_node_path19.join)(directory, path6), { recursive: true });
+var rmDiagram = (directory) => async (path8) => {
+  await import_promises14.default.rm((0, import_node_path21.join)(directory, path8), { recursive: true });
   invalidateFileCache();
 };
 var rmDiagramById = (directory) => async (id, version, persistFiles) => {
@@ -2086,7 +2485,7 @@ var diagramHasVersion = (directory) => async (id, version) => {
 var addFileToDiagram = (directory) => async (id, file, version) => addFileToResource(directory, id, file, version, { type: "diagram" });
 
 // src/index.ts
-var src_default = (path6) => {
+var src_default = (path8) => {
   return {
     /**
      * Returns an events from EventCatalog
@@ -2094,13 +2493,13 @@ var src_default = (path6) => {
      * @param version - Optional id of the version to get (supports semver)
      * @returns Event|Undefined
      */
-    getEvent: getEvent((0, import_node_path20.join)(path6)),
+    getEvent: getEvent((0, import_node_path22.join)(path8)),
     /**
      * Returns all events from EventCatalog
      * @param latestOnly - optional boolean, set to true to get only latest versions
      * @returns Event[]|Undefined
      */
-    getEvents: getEvents((0, import_node_path20.join)(path6)),
+    getEvents: getEvents((0, import_node_path22.join)(path8)),
     /**
      * Adds an event to EventCatalog
      *
@@ -2108,7 +2507,7 @@ var src_default = (path6) => {
      * @param options - Optional options to write the event
      *
      */
-    writeEvent: writeEvent((0, import_node_path20.join)(path6, "events")),
+    writeEvent: writeEvent((0, import_node_path22.join)(path8, "events")),
     /**
      * Adds an event to a service in EventCatalog
      *
@@ -2117,26 +2516,26 @@ var src_default = (path6) => {
      * @param options - Optional options to write the event
      *
      */
-    writeEventToService: writeEventToService((0, import_node_path20.join)(path6)),
+    writeEventToService: writeEventToService((0, import_node_path22.join)(path8)),
     /**
      * 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_path20.join)(path6, "events")),
+    rmEvent: rmEvent((0, import_node_path22.join)(path8, "events")),
     /**
      * Remove an event by an Event id
      *
      * @param id - The id of the event you want to remove
      *
      */
-    rmEventById: rmEventById((0, import_node_path20.join)(path6)),
+    rmEventById: rmEventById((0, import_node_path22.join)(path8)),
     /**
      * Moves a given event id to the version directory
      * @param directory
      */
-    versionEvent: versionEvent((0, import_node_path20.join)(path6)),
+    versionEvent: versionEvent((0, import_node_path22.join)(path8)),
     /**
      * Adds a file to the given event
      * @param id - The id of the event to add the file to
@@ -2144,7 +2543,7 @@ var src_default = (path6) => {
      * @param version - Optional version of the event to add the file to
      * @returns
      */
-    addFileToEvent: addFileToEvent((0, import_node_path20.join)(path6)),
+    addFileToEvent: addFileToEvent((0, import_node_path22.join)(path8)),
     /**
      * Adds a schema to the given event
      * @param id - The id of the event to add the schema to
@@ -2152,14 +2551,14 @@ var src_default = (path6) => {
      * @param version - Optional version of the event to add the schema to
      * @returns
      */
-    addSchemaToEvent: addSchemaToEvent((0, import_node_path20.join)(path6)),
+    addSchemaToEvent: addSchemaToEvent((0, import_node_path22.join)(path8)),
     /**
      * Check to see if an event version exists
      * @param id - The id of the event
      * @param version - The version of the event (supports semver)
      * @returns
      */
-    eventHasVersion: eventHasVersion((0, import_node_path20.join)(path6)),
+    eventHasVersion: eventHasVersion((0, import_node_path22.join)(path8)),
     /**
      * ================================
      *            Commands
@@ -2171,13 +2570,13 @@ var src_default = (path6) => {
      * @param version - Optional id of the version to get (supports semver)
      * @returns Command|Undefined
      */
-    getCommand: getCommand((0, import_node_path20.join)(path6)),
+    getCommand: getCommand((0, import_node_path22.join)(path8)),
     /**
      * Returns all commands from EventCatalog
      * @param latestOnly - optional boolean, set to true to get only latest versions
      * @returns Command[]|Undefined
      */
-    getCommands: getCommands((0, import_node_path20.join)(path6)),
+    getCommands: getCommands((0, import_node_path22.join)(path8)),
     /**
      * Adds an command to EventCatalog
      *
@@ -2185,7 +2584,7 @@ var src_default = (path6) => {
      * @param options - Optional options to write the command
      *
      */
-    writeCommand: writeCommand((0, import_node_path20.join)(path6, "commands")),
+    writeCommand: writeCommand((0, import_node_path22.join)(path8, "commands")),
     /**
      * Adds a command to a service in EventCatalog
      *
@@ -2194,26 +2593,26 @@ var src_default = (path6) => {
      * @param options - Optional options to write the command
      *
      */
-    writeCommandToService: writeCommandToService((0, import_node_path20.join)(path6)),
+    writeCommandToService: writeCommandToService((0, import_node_path22.join)(path8)),
     /**
      * Remove an command to EventCatalog (modeled on the standard POSIX rm utility)
      *
      * @param path - The path to your command, e.g. `/Inventory/InventoryAdjusted`
      *
      */
-    rmCommand: rmCommand((0, import_node_path20.join)(path6, "commands")),
+    rmCommand: rmCommand((0, import_node_path22.join)(path8, "commands")),
     /**
      * Remove an command by an Event id
      *
      * @param id - The id of the command you want to remove
      *
      */
-    rmCommandById: rmCommandById((0, import_node_path20.join)(path6)),
+    rmCommandById: rmCommandById((0, import_node_path22.join)(path8)),
     /**
      * Moves a given command id to the version directory
      * @param directory
      */
-    versionCommand: versionCommand((0, import_node_path20.join)(path6)),
+    versionCommand: versionCommand((0, import_node_path22.join)(path8)),
     /**
      * Adds a file to the given command
      * @param id - The id of the command to add the file to
@@ -2221,7 +2620,7 @@ var src_default = (path6) => {
      * @param version - Optional version of the command to add the file to
      * @returns
      */
-    addFileToCommand: addFileToCommand((0, import_node_path20.join)(path6)),
+    addFileToCommand: addFileToCommand((0, import_node_path22.join)(path8)),
     /**
      * Adds a schema to the given command
      * @param id - The id of the command to add the schema to
@@ -2229,14 +2628,14 @@ var src_default = (path6) => {
      * @param version - Optional version of the command to add the schema to
      * @returns
      */
-    addSchemaToCommand: addSchemaToCommand((0, import_node_path20.join)(path6)),
+    addSchemaToCommand: addSchemaToCommand((0, import_node_path22.join)(path8)),
     /**
      * Check to see if a command version exists
      * @param id - The id of the command
      * @param version - The version of the command (supports semver)
      * @returns
      */
-    commandHasVersion: commandHasVersion((0, import_node_path20.join)(path6)),
+    commandHasVersion: commandHasVersion((0, import_node_path22.join)(path8)),
     /**
      * ================================
      *            Queries
@@ -2248,13 +2647,13 @@ var src_default = (path6) => {
      * @param version - Optional id of the version to get (supports semver)
      * @returns Query|Undefined
      */
-    getQuery: getQuery((0, import_node_path20.join)(path6)),
+    getQuery: getQuery((0, import_node_path22.join)(path8)),
     /**
      * Returns all queries from EventCatalog
      * @param latestOnly - optional boolean, set to true to get only latest versions
      * @returns Query[]|Undefined
      */
-    getQueries: getQueries((0, import_node_path20.join)(path6)),
+    getQueries: getQueries((0, import_node_path22.join)(path8)),
     /**
      * Adds a query to EventCatalog
      *
@@ -2262,7 +2661,7 @@ var src_default = (path6) => {
      * @param options - Optional options to write the event
      *
      */
-    writeQuery: writeQuery((0, import_node_path20.join)(path6, "queries")),
+    writeQuery: writeQuery((0, import_node_path22.join)(path8, "queries")),
     /**
      * Adds a query to a service in EventCatalog
      *
@@ -2271,26 +2670,26 @@ var src_default = (path6) => {
      * @param options - Optional options to write the query
      *
      */
-    writeQueryToService: writeQueryToService((0, import_node_path20.join)(path6)),
+    writeQueryToService: writeQueryToService((0, import_node_path22.join)(path8)),
     /**
      * Remove an query to EventCatalog (modeled on the standard POSIX rm utility)
      *
      * @param path - The path to your query, e.g. `/Orders/GetOrder`
      *
      */
-    rmQuery: rmQuery((0, import_node_path20.join)(path6, "queries")),
+    rmQuery: rmQuery((0, import_node_path22.join)(path8, "queries")),
     /**
      * Remove a query by a Query id
      *
      * @param id - The id of the query you want to remove
      *
      */
-    rmQueryById: rmQueryById((0, import_node_path20.join)(path6)),
+    rmQueryById: rmQueryById((0, import_node_path22.join)(path8)),
     /**
      * Moves a given query id to the version directory
      * @param directory
      */
-    versionQuery: versionQuery((0, import_node_path20.join)(path6)),
+    versionQuery: versionQuery((0, import_node_path22.join)(path8)),
     /**
      * Adds a file to the given query
      * @param id - The id of the query to add the file to
@@ -2298,7 +2697,7 @@ var src_default = (path6) => {
      * @param version - Optional version of the query to add the file to
      * @returns
      */
-    addFileToQuery: addFileToQuery((0, import_node_path20.join)(path6)),
+    addFileToQuery: addFileToQuery((0, import_node_path22.join)(path8)),
     /**
      * Adds a schema to the given query
      * @param id - The id of the query to add the schema to
@@ -2306,14 +2705,14 @@ var src_default = (path6) => {
      * @param version - Optional version of the query to add the schema to
      * @returns
      */
-    addSchemaToQuery: addSchemaToQuery((0, import_node_path20.join)(path6)),
+    addSchemaToQuery: addSchemaToQuery((0, import_node_path22.join)(path8)),
     /**
      * Check to see if an query version exists
      * @param id - The id of the query
      * @param version - The version of the query (supports semver)
      * @returns
      */
-    queryHasVersion: queryHasVersion((0, import_node_path20.join)(path6)),
+    queryHasVersion: queryHasVersion((0, import_node_path22.join)(path8)),
     /**
      * ================================
      *            Channels
@@ -2325,13 +2724,13 @@ var src_default = (path6) => {
      * @param version - Optional id of the version to get (supports semver)
      * @returns Channel|Undefined
      */
-    getChannel: getChannel((0, import_node_path20.join)(path6)),
+    getChannel: getChannel((0, import_node_path22.join)(path8)),
     /**
      * Returns all channels from EventCatalog
      * @param latestOnly - optional boolean, set to true to get only latest versions
      * @returns Channel[]|Undefined
      */
-    getChannels: getChannels((0, import_node_path20.join)(path6)),
+    getChannels: getChannels((0, import_node_path22.join)(path8)),
     /**
      * Adds an channel to EventCatalog
      *
@@ -2339,33 +2738,33 @@ var src_default = (path6) => {
      * @param options - Optional options to write the channel
      *
      */
-    writeChannel: writeChannel((0, import_node_path20.join)(path6, "channels")),
+    writeChannel: writeChannel((0, import_node_path22.join)(path8, "channels")),
     /**
      * Remove an channel to EventCatalog (modeled on the standard POSIX rm utility)
      *
      * @param path - The path to your channel, e.g. `/Inventory/InventoryAdjusted`
      *
      */
-    rmChannel: rmChannel((0, import_node_path20.join)(path6, "channels")),
+    rmChannel: rmChannel((0, import_node_path22.join)(path8, "channels")),
     /**
      * Remove an channel by an Event id
      *
      * @param id - The id of the channel you want to remove
      *
      */
-    rmChannelById: rmChannelById((0, import_node_path20.join)(path6)),
+    rmChannelById: rmChannelById((0, import_node_path22.join)(path8)),
     /**
      * Moves a given channel id to the version directory
      * @param directory
      */
-    versionChannel: versionChannel((0, import_node_path20.join)(path6)),
+    versionChannel: versionChannel((0, import_node_path22.join)(path8)),
     /**
      * Check to see if a channel version exists
      * @param id - The id of the channel
      * @param version - The version of the channel (supports semver)
      * @returns
      */
-    channelHasVersion: channelHasVersion((0, import_node_path20.join)(path6)),
+    channelHasVersion: channelHasVersion((0, import_node_path22.join)(path8)),
     /**
      * Add a channel to an event
      *
@@ -2382,7 +2781,7 @@ var src_default = (path6) => {
      *
      * ```
      */
-    addEventToChannel: addMessageToChannel((0, import_node_path20.join)(path6), "events"),
+    addEventToChannel: addMessageToChannel((0, import_node_path22.join)(path8), "events"),
     /**
      * Add a channel to an command
      *
@@ -2399,7 +2798,7 @@ var src_default = (path6) => {
      *
      * ```
      */
-    addCommandToChannel: addMessageToChannel((0, import_node_path20.join)(path6), "commands"),
+    addCommandToChannel: addMessageToChannel((0, import_node_path22.join)(path8), "commands"),
     /**
      * Add a channel to an query
      *
@@ -2416,7 +2815,7 @@ var src_default = (path6) => {
      *
      * ```
      */
-    addQueryToChannel: addMessageToChannel((0, import_node_path20.join)(path6), "queries"),
+    addQueryToChannel: addMessageToChannel((0, import_node_path22.join)(path8), "queries"),
     /**
      * ================================
      *            SERVICES
@@ -2429,14 +2828,14 @@ var src_default = (path6) => {
      * @param options - Optional options to write the event
      *
      */
-    writeService: writeService((0, import_node_path20.join)(path6, "services")),
+    writeService: writeService((0, import_node_path22.join)(path8, "services")),
     /**
      * Adds a versioned service to EventCatalog
      *
      * @param service - The service to write
      *
      */
-    writeVersionedService: writeVersionedService((0, import_node_path20.join)(path6, "services")),
+    writeVersionedService: writeVersionedService((0, import_node_path22.join)(path8, "services")),
     /**
      * Adds a service to a domain in EventCatalog
      *
@@ -2445,45 +2844,45 @@ var src_default = (path6) => {
      * @param options - Optional options to write the event
      *
      */
-    writeServiceToDomain: writeServiceToDomain((0, import_node_path20.join)(path6, "domains")),
+    writeServiceToDomain: writeServiceToDomain((0, import_node_path22.join)(path8, "domains")),
     /**
      * Returns a service from EventCatalog
      * @param id - The id of the service to retrieve
      * @param version - Optional id of the version to get (supports semver)
      * @returns Service|Undefined
      */
-    getService: getService((0, import_node_path20.join)(path6)),
+    getService: getService((0, import_node_path22.join)(path8)),
     /**
      * Returns a service from EventCatalog by it's path.
      * @param path - The path to the service to retrieve
      * @returns Service|Undefined
      */
-    getServiceByPath: getServiceByPath((0, import_node_path20.join)(path6)),
+    getServiceByPath: getServiceByPath((0, import_node_path22.join)(path8)),
     /**
      * Returns all services from EventCatalog
      * @param latestOnly - optional boolean, set to true to get only latest versions
      * @returns Service[]|Undefined
      */
-    getServices: getServices((0, import_node_path20.join)(path6)),
+    getServices: getServices((0, import_node_path22.join)(path8)),
     /**
      * Moves a given service id to the version directory
      * @param directory
      */
-    versionService: versionService((0, import_node_path20.join)(path6)),
+    versionService: versionService((0, import_node_path22.join)(path8)),
     /**
      * 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_path20.join)(path6, "services")),
+    rmService: rmService((0, import_node_path22.join)(path8, "services")),
     /**
      * Remove an service by an service id
      *
      * @param id - The id of the service you want to remove
      *
      */
-    rmServiceById: rmServiceById((0, import_node_path20.join)(path6)),
+    rmServiceById: rmServiceById((0, import_node_path22.join)(path8)),
     /**
      * Adds a file to the given service
      * @param id - The id of the service to add the file to
@@ -2491,21 +2890,21 @@ var src_default = (path6) => {
      * @param version - Optional version of the service to add the file to
      * @returns
      */
-    addFileToService: addFileToService((0, import_node_path20.join)(path6)),
+    addFileToService: addFileToService((0, import_node_path22.join)(path8)),
     /**
      * Returns the specifications for a given service
      * @param id - The id of the service to retrieve the specifications for
      * @param version - Optional version of the service
      * @returns
      */
-    getSpecificationFilesForService: getSpecificationFilesForService((0, import_node_path20.join)(path6)),
+    getSpecificationFilesForService: getSpecificationFilesForService((0, import_node_path22.join)(path8)),
     /**
      * Check to see if a service version exists
      * @param id - The id of the service
      * @param version - The version of the service (supports semver)
      * @returns
      */
-    serviceHasVersion: serviceHasVersion((0, import_node_path20.join)(path6)),
+    serviceHasVersion: serviceHasVersion((0, import_node_path22.join)(path8)),
     /**
      * Add an event to a service by it's id.
      *
@@ -2525,7 +2924,7 @@ var src_default = (path6) => {
      *
      * ```
      */
-    addEventToService: addMessageToService((0, import_node_path20.join)(path6)),
+    addEventToService: addMessageToService((0, import_node_path22.join)(path8)),
     /**
      * Add a data store to a service by it's id.
      *
@@ -2542,7 +2941,7 @@ var src_default = (path6) => {
      *
      * ```
      */
-    addDataStoreToService: addDataStoreToService((0, import_node_path20.join)(path6)),
+    addDataStoreToService: addDataStoreToService((0, import_node_path22.join)(path8)),
     /**
      * Add a command to a service by it's id.
      *
@@ -2562,7 +2961,7 @@ var src_default = (path6) => {
      *
      * ```
      */
-    addCommandToService: addMessageToService((0, import_node_path20.join)(path6)),
+    addCommandToService: addMessageToService((0, import_node_path22.join)(path8)),
     /**
      * Add a query to a service by it's id.
      *
@@ -2582,7 +2981,7 @@ var src_default = (path6) => {
      *
      * ```
      */
-    addQueryToService: addMessageToService((0, import_node_path20.join)(path6)),
+    addQueryToService: addMessageToService((0, import_node_path22.join)(path8)),
     /**
      * Add an entity to a service by its id.
      *
@@ -2600,7 +2999,7 @@ var src_default = (path6) => {
      *
      * ```
      */
-    addEntityToService: addEntityToService((0, import_node_path20.join)(path6)),
+    addEntityToService: addEntityToService((0, import_node_path22.join)(path8)),
     /**
      * Check to see if a service exists by it's path.
      *
@@ -2617,13 +3016,13 @@ var src_default = (path6) => {
      * @param path - The path to the service to check
      * @returns boolean
      */
-    isService: isService((0, import_node_path20.join)(path6)),
+    isService: isService((0, import_node_path22.join)(path8)),
     /**
      * Converts a file to a service.
      * @param file - The file to convert to a service.
      * @returns The service.
      */
-    toService: toService((0, import_node_path20.join)(path6)),
+    toService: toService((0, import_node_path22.join)(path8)),
     /**
      * ================================
      *            Domains
@@ -2636,39 +3035,39 @@ var src_default = (path6) => {
      * @param options - Optional options to write the event
      *
      */
-    writeDomain: writeDomain((0, import_node_path20.join)(path6, "domains")),
+    writeDomain: writeDomain((0, import_node_path22.join)(path8, "domains")),
     /**
      * Returns a domain from EventCatalog
      * @param id - The id of the domain to retrieve
      * @param version - Optional id of the version to get (supports semver)
      * @returns Domain|Undefined
      */
-    getDomain: getDomain((0, import_node_path20.join)(path6, "domains")),
+    getDomain: getDomain((0, import_node_path22.join)(path8, "domains")),
     /**
      * Returns all domains from EventCatalog
      * @param latestOnly - optional boolean, set to true to get only latest versions
      * @returns Domain[]|Undefined
      */
-    getDomains: getDomains((0, import_node_path20.join)(path6)),
+    getDomains: getDomains((0, import_node_path22.join)(path8)),
     /**
      * Moves a given domain id to the version directory
      * @param directory
      */
-    versionDomain: versionDomain((0, import_node_path20.join)(path6, "domains")),
+    versionDomain: versionDomain((0, import_node_path22.join)(path8, "domains")),
     /**
      * Remove a domain from EventCatalog (modeled on the standard POSIX rm utility)
      *
      * @param path - The path to your domain, e.g. `/Payment`
      *
      */
-    rmDomain: rmDomain((0, import_node_path20.join)(path6, "domains")),
+    rmDomain: rmDomain((0, import_node_path22.join)(path8, "domains")),
     /**
      * Remove an service by an domain id
      *
      * @param id - The id of the domain you want to remove
      *
      */
-    rmDomainById: rmDomainById((0, import_node_path20.join)(path6, "domains")),
+    rmDomainById: rmDomainById((0, import_node_path22.join)(path8, "domains")),
     /**
      * Adds a file to the given domain
      * @param id - The id of the domain to add the file to
@@ -2676,28 +3075,28 @@ var src_default = (path6) => {
      * @param version - Optional version of the domain to add the file to
      * @returns
      */
-    addFileToDomain: addFileToDomain((0, import_node_path20.join)(path6, "domains")),
+    addFileToDomain: addFileToDomain((0, import_node_path22.join)(path8, "domains")),
     /**
      * Adds an ubiquitous language dictionary to a domain
      * @param id - The id of the domain to add the ubiquitous language to
      * @param ubiquitousLanguageDictionary - The ubiquitous language dictionary to add
      * @param version - Optional version of the domain to add the ubiquitous language to
      */
-    addUbiquitousLanguageToDomain: addUbiquitousLanguageToDomain((0, import_node_path20.join)(path6, "domains")),
+    addUbiquitousLanguageToDomain: addUbiquitousLanguageToDomain((0, import_node_path22.join)(path8, "domains")),
     /**
      * Get the ubiquitous language dictionary from a domain
      * @param id - The id of the domain to get the ubiquitous language from
      * @param version - Optional version of the domain to get the ubiquitous language from
      * @returns
      */
-    getUbiquitousLanguageFromDomain: getUbiquitousLanguageFromDomain((0, import_node_path20.join)(path6, "domains")),
+    getUbiquitousLanguageFromDomain: getUbiquitousLanguageFromDomain((0, import_node_path22.join)(path8, "domains")),
     /**
      * Check to see if a domain version exists
      * @param id - The id of the domain
      * @param version - The version of the domain (supports semver)
      * @returns
      */
-    domainHasVersion: domainHasVersion((0, import_node_path20.join)(path6)),
+    domainHasVersion: domainHasVersion((0, import_node_path22.join)(path8)),
     /**
      * Adds a given service to a domain
      * @param id - The id of the domain
@@ -2705,7 +3104,7 @@ var src_default = (path6) => {
      * @param version - (Optional) The version of the domain to add the service to
      * @returns
      */
-    addServiceToDomain: addServiceToDomain((0, import_node_path20.join)(path6, "domains")),
+    addServiceToDomain: addServiceToDomain((0, import_node_path22.join)(path8, "domains")),
     /**
      * Adds a given subdomain to a domain
      * @param id - The id of the domain
@@ -2713,7 +3112,7 @@ var src_default = (path6) => {
      * @param version - (Optional) The version of the domain to add the subdomain to
      * @returns
      */
-    addSubDomainToDomain: addSubDomainToDomain((0, import_node_path20.join)(path6, "domains")),
+    addSubDomainToDomain: addSubDomainToDomain((0, import_node_path22.join)(path8, "domains")),
     /**
      * Adds an entity to a domain
      * @param id - The id of the domain
@@ -2721,7 +3120,7 @@ var src_default = (path6) => {
      * @param version - (Optional) The version of the domain to add the entity to
      * @returns
      */
-    addEntityToDomain: addEntityToDomain((0, import_node_path20.join)(path6, "domains")),
+    addEntityToDomain: addEntityToDomain((0, import_node_path22.join)(path8, "domains")),
     /**
      * Add an event to a domain by its id.
      *
@@ -2739,7 +3138,7 @@ var src_default = (path6) => {
      *
      * ```
      */
-    addEventToDomain: addMessageToDomain((0, import_node_path20.join)(path6, "domains")),
+    addEventToDomain: addMessageToDomain((0, import_node_path22.join)(path8, "domains")),
     /**
      * Add a command to a domain by its id.
      *
@@ -2757,7 +3156,7 @@ var src_default = (path6) => {
      *
      * ```
      */
-    addCommandToDomain: addMessageToDomain((0, import_node_path20.join)(path6, "domains")),
+    addCommandToDomain: addMessageToDomain((0, import_node_path22.join)(path8, "domains")),
     /**
      * Add a query to a domain by its id.
      *
@@ -2775,7 +3174,7 @@ var src_default = (path6) => {
      *
      * ```
      */
-    addQueryToDomain: addMessageToDomain((0, import_node_path20.join)(path6, "domains")),
+    addQueryToDomain: addMessageToDomain((0, import_node_path22.join)(path8, "domains")),
     /**
      * ================================
      *            Teams
@@ -2788,25 +3187,25 @@ var src_default = (path6) => {
      * @param options - Optional options to write the team
      *
      */
-    writeTeam: writeTeam((0, import_node_path20.join)(path6, "teams")),
+    writeTeam: writeTeam((0, import_node_path22.join)(path8, "teams")),
     /**
      * Returns a team from EventCatalog
      * @param id - The id of the team to retrieve
      * @returns Team|Undefined
      */
-    getTeam: getTeam((0, import_node_path20.join)(path6, "teams")),
+    getTeam: getTeam((0, import_node_path22.join)(path8, "teams")),
     /**
      * Returns all teams from EventCatalog
      * @returns Team[]|Undefined
      */
-    getTeams: getTeams((0, import_node_path20.join)(path6, "teams")),
+    getTeams: getTeams((0, import_node_path22.join)(path8, "teams")),
     /**
      * Remove a team by the team id
      *
      * @param id - The id of the team you want to remove
      *
      */
-    rmTeamById: rmTeamById((0, import_node_path20.join)(path6, "teams")),
+    rmTeamById: rmTeamById((0, import_node_path22.join)(path8, "teams")),
     /**
      * ================================
      *            Users
@@ -2819,25 +3218,25 @@ var src_default = (path6) => {
      * @param options - Optional options to write the user
      *
      */
-    writeUser: writeUser((0, import_node_path20.join)(path6, "users")),
+    writeUser: writeUser((0, import_node_path22.join)(path8, "users")),
     /**
      * Returns a user from EventCatalog
      * @param id - The id of the user to retrieve
      * @returns User|Undefined
      */
-    getUser: getUser((0, import_node_path20.join)(path6, "users")),
+    getUser: getUser((0, import_node_path22.join)(path8, "users")),
     /**
      * Returns all user from EventCatalog
      * @returns User[]|Undefined
      */
-    getUsers: getUsers((0, import_node_path20.join)(path6)),
+    getUsers: getUsers((0, import_node_path22.join)(path8)),
     /**
      * Remove a user by the user id
      *
      * @param id - The id of the user you want to remove
      *
      */
-    rmUserById: rmUserById((0, import_node_path20.join)(path6, "users")),
+    rmUserById: rmUserById((0, import_node_path22.join)(path8, "users")),
     /**
      * ================================
      *            Custom Docs
@@ -2848,32 +3247,32 @@ var src_default = (path6) => {
      * @param path - The path to the custom doc to retrieve
      * @returns CustomDoc|Undefined
      */
-    getCustomDoc: getCustomDoc((0, import_node_path20.join)(path6, "docs")),
+    getCustomDoc: getCustomDoc((0, import_node_path22.join)(path8, "docs")),
     /**
      * Returns all custom docs from EventCatalog
      * @param options - Optional options to get custom docs from a specific path
      * @returns CustomDoc[]|Undefined
      */
-    getCustomDocs: getCustomDocs((0, import_node_path20.join)(path6, "docs")),
+    getCustomDocs: getCustomDocs((0, import_node_path22.join)(path8, "docs")),
     /**
      * Writes a custom doc to EventCatalog
      * @param customDoc - The custom doc to write
      * @param options - Optional options to write the custom doc
      *
      */
-    writeCustomDoc: writeCustomDoc((0, import_node_path20.join)(path6, "docs")),
+    writeCustomDoc: writeCustomDoc((0, import_node_path22.join)(path8, "docs")),
     /**
      * Removes a custom doc from EventCatalog
      * @param path - The path to the custom doc to remove
      *
      */
-    rmCustomDoc: rmCustomDoc((0, import_node_path20.join)(path6, "docs")),
+    rmCustomDoc: rmCustomDoc((0, import_node_path22.join)(path8, "docs")),
     /**
      * Dumps the catalog to a JSON file.
      * @param directory - The directory to dump the catalog to
      * @returns A JSON file with the catalog
      */
-    dumpCatalog: dumpCatalog((0, import_node_path20.join)(path6)),
+    dumpCatalog: dumpCatalog((0, import_node_path22.join)(path8)),
     /**
      * Returns the event catalog configuration file.
      * The event catalog configuration file is the file that contains the configuration for the event catalog.
@@ -2881,7 +3280,47 @@ var src_default = (path6) => {
      * @param directory - The directory of the catalog.
      * @returns A JSON object with the configuration for the event catalog.
      */
-    getEventCatalogConfigurationFile: getEventCatalogConfigurationFile((0, import_node_path20.join)(path6)),
+    getEventCatalogConfigurationFile: getEventCatalogConfigurationFile((0, import_node_path22.join)(path8)),
+    /**
+     * ================================
+     *            Changelogs
+     * ================================
+     */
+    /**
+     * Writes a changelog entry to a resource in EventCatalog
+     *
+     * @param id - The id of the resource to write the changelog to
+     * @param changelog - The changelog entry to write
+     * @param options - Optional options (version, format)
+     *
+     */
+    writeChangelog: writeChangelog((0, import_node_path22.join)(path8)),
+    /**
+     * Appends a changelog entry to an existing changelog for a resource.
+     * If no changelog exists, one is created.
+     *
+     * @param id - The id of the resource to append the changelog to
+     * @param changelog - The changelog entry to append
+     * @param options - Optional options (version, format)
+     *
+     */
+    appendChangelog: appendChangelog((0, import_node_path22.join)(path8)),
+    /**
+     * Returns the changelog for a resource in EventCatalog
+     *
+     * @param id - The id of the resource to get the changelog for
+     * @param options - Optional options (version)
+     * @returns Changelog|Undefined
+     */
+    getChangelog: getChangelog((0, import_node_path22.join)(path8)),
+    /**
+     * Removes the changelog for a resource in EventCatalog
+     *
+     * @param id - The id of the resource to remove the changelog from
+     * @param options - Optional options (version)
+     *
+     */
+    rmChangelog: rmChangelog((0, import_node_path22.join)(path8)),
     /**
      * ================================
      *            Resources Utils
@@ -2906,33 +3345,33 @@ var src_default = (path6) => {
      * @param path - The path to the message to retrieve
      * @returns Message|Undefined
      */
-    getMessageBySchemaPath: getMessageBySchemaPath((0, import_node_path20.join)(path6)),
+    getMessageBySchemaPath: getMessageBySchemaPath((0, import_node_path22.join)(path8)),
     /**
      * Returns the producers and consumers (services) for a given message
      * @param id - The id of the message to get the producers and consumers for
      * @param version - Optional version of the message
      * @returns { producers: Service[], consumers: Service[] }
      */
-    getProducersAndConsumersForMessage: getProducersAndConsumersForMessage((0, import_node_path20.join)(path6)),
+    getProducersAndConsumersForMessage: getProducersAndConsumersForMessage((0, import_node_path22.join)(path8)),
     /**
      * Returns the consumers of a given schema path
      * @param path - The path to the schema to get the consumers for
      * @returns Service[]
      */
-    getConsumersOfSchema: getConsumersOfSchema((0, import_node_path20.join)(path6)),
+    getConsumersOfSchema: getConsumersOfSchema((0, import_node_path22.join)(path8)),
     /**
      * Returns the producers of a given schema path
      * @param path - The path to the schema to get the producers for
      * @returns Service[]
      */
-    getProducersOfSchema: getProducersOfSchema((0, import_node_path20.join)(path6)),
+    getProducersOfSchema: getProducersOfSchema((0, import_node_path22.join)(path8)),
     /**
      * Returns the owners for a given resource (e.g domain, service, event, command, query, etc.)
      * @param id - The id of the resource to get the owners for
      * @param version - Optional version of the resource
      * @returns { owners: User[] }
      */
-    getOwnersForResource: getOwnersForResource((0, import_node_path20.join)(path6)),
+    getOwnersForResource: getOwnersForResource((0, import_node_path22.join)(path8)),
     /**
      * ================================
      *            Entities
@@ -2944,13 +3383,13 @@ var src_default = (path6) => {
      * @param version - Optional id of the version to get (supports semver)
      * @returns Entity|Undefined
      */
-    getEntity: getEntity((0, import_node_path20.join)(path6)),
+    getEntity: getEntity((0, import_node_path22.join)(path8)),
     /**
      * Returns all entities from EventCatalog
      * @param latestOnly - optional boolean, set to true to get only latest versions
      * @returns Entity[]|Undefined
      */
-    getEntities: getEntities((0, import_node_path20.join)(path6)),
+    getEntities: getEntities((0, import_node_path22.join)(path8)),
     /**
      * Adds an entity to EventCatalog
      *
@@ -2958,33 +3397,33 @@ var src_default = (path6) => {
      * @param options - Optional options to write the entity
      *
      */
-    writeEntity: writeEntity((0, import_node_path20.join)(path6, "entities")),
+    writeEntity: writeEntity((0, import_node_path22.join)(path8, "entities")),
     /**
      * Remove an entity from EventCatalog (modeled on the standard POSIX rm utility)
      *
      * @param path - The path to your entity, e.g. `/User`
      *
      */
-    rmEntity: rmEntity((0, import_node_path20.join)(path6, "entities")),
+    rmEntity: rmEntity((0, import_node_path22.join)(path8, "entities")),
     /**
      * Remove an entity by an entity id
      *
      * @param id - The id of the entity you want to remove
      *
      */
-    rmEntityById: rmEntityById((0, import_node_path20.join)(path6)),
+    rmEntityById: rmEntityById((0, import_node_path22.join)(path8)),
     /**
      * Moves a given entity id to the version directory
      * @param id - The id of the entity to version
      */
-    versionEntity: versionEntity((0, import_node_path20.join)(path6)),
+    versionEntity: versionEntity((0, import_node_path22.join)(path8)),
     /**
      * Check to see if an entity version exists
      * @param id - The id of the entity
      * @param version - The version of the entity (supports semver)
      * @returns
      */
-    entityHasVersion: entityHasVersion((0, import_node_path20.join)(path6)),
+    entityHasVersion: entityHasVersion((0, import_node_path22.join)(path8)),
     /**
      * ================================
      *            Data Stores
@@ -2996,42 +3435,42 @@ var src_default = (path6) => {
      * @param options - Optional options to write the data store
      *
      */
-    writeDataStore: writeDataStore((0, import_node_path20.join)(path6, "containers")),
+    writeDataStore: writeDataStore((0, import_node_path22.join)(path8, "containers")),
     /**
      * Returns a data store from EventCatalog
      * @param id - The id of the data store to retrieve
      * @param version - Optional id of the version to get (supports semver)
      * @returns Container|Undefined
      */
-    getDataStore: getDataStore((0, import_node_path20.join)(path6)),
+    getDataStore: getDataStore((0, import_node_path22.join)(path8)),
     /**
      * Returns all data stores from EventCatalog
      * @param latestOnly - optional boolean, set to true to get only latest versions
      * @returns Container[]|Undefined
      */
-    getDataStores: getDataStores((0, import_node_path20.join)(path6)),
+    getDataStores: getDataStores((0, import_node_path22.join)(path8)),
     /**
      * Version a data store by its id
      * @param id - The id of the data store to version
      */
-    versionDataStore: versionDataStore((0, import_node_path20.join)(path6, "containers")),
+    versionDataStore: versionDataStore((0, import_node_path22.join)(path8, "containers")),
     /**
      * Remove a data store by its path
      * @param path - The path to the data store to remove
      */
-    rmDataStore: rmDataStore((0, import_node_path20.join)(path6, "containers")),
+    rmDataStore: rmDataStore((0, import_node_path22.join)(path8, "containers")),
     /**
      * Remove a data store by its id
      * @param id - The id of the data store to remove
      */
-    rmDataStoreById: rmDataStoreById((0, import_node_path20.join)(path6)),
+    rmDataStoreById: rmDataStoreById((0, import_node_path22.join)(path8)),
     /**
      * Check to see if a data store version exists
      * @param id - The id of the data store
      * @param version - The version of the data store (supports semver)
      * @returns
      */
-    dataStoreHasVersion: dataStoreHasVersion((0, import_node_path20.join)(path6)),
+    dataStoreHasVersion: dataStoreHasVersion((0, import_node_path22.join)(path8)),
     /**
      * Adds a file to a data store by its id
      * @param id - The id of the data store to add the file to
@@ -3039,14 +3478,14 @@ var src_default = (path6) => {
      * @param version - Optional version of the data store to add the file to
      * @returns
      */
-    addFileToDataStore: addFileToDataStore((0, import_node_path20.join)(path6)),
+    addFileToDataStore: addFileToDataStore((0, import_node_path22.join)(path8)),
     /**
      * Writes a data store to a service by its id
      * @param dataStore - The data store to write
      * @param service - The service to write the data store to
      * @returns
      */
-    writeDataStoreToService: writeDataStoreToService((0, import_node_path20.join)(path6)),
+    writeDataStoreToService: writeDataStoreToService((0, import_node_path22.join)(path8)),
     /**
      * ================================
      *            Data Products
@@ -3058,7 +3497,7 @@ var src_default = (path6) => {
      * @param options - Optional options to write the data product
      *
      */
-    writeDataProduct: writeDataProduct((0, import_node_path20.join)(path6, "data-products")),
+    writeDataProduct: writeDataProduct((0, import_node_path22.join)(path8, "data-products")),
     /**
      * Writes a data product to a domain in EventCatalog
      * @param dataProduct - The data product to write
@@ -3066,43 +3505,43 @@ var src_default = (path6) => {
      * @param options - Optional options to write the data product
      *
      */
-    writeDataProductToDomain: writeDataProductToDomain((0, import_node_path20.join)(path6, "domains")),
+    writeDataProductToDomain: writeDataProductToDomain((0, import_node_path22.join)(path8, "domains")),
     /**
      * Returns a data product from EventCatalog
      * @param id - The id of the data product to retrieve
      * @param version - Optional id of the version to get (supports semver)
      * @returns DataProduct|Undefined
      */
-    getDataProduct: getDataProduct((0, import_node_path20.join)(path6)),
+    getDataProduct: getDataProduct((0, import_node_path22.join)(path8)),
     /**
      * Returns all data products from EventCatalog
      * @param latestOnly - optional boolean, set to true to get only latest versions
      * @returns DataProduct[]|Undefined
      */
-    getDataProducts: getDataProducts((0, import_node_path20.join)(path6)),
+    getDataProducts: getDataProducts((0, import_node_path22.join)(path8)),
     /**
      * Version a data product by its id
      * @param id - The id of the data product to version
      */
-    versionDataProduct: versionDataProduct((0, import_node_path20.join)(path6)),
+    versionDataProduct: versionDataProduct((0, import_node_path22.join)(path8)),
     /**
      * Remove a data product by its path
      * @param path - The path to the data product to remove
      */
-    rmDataProduct: rmDataProduct((0, import_node_path20.join)(path6, "data-products")),
+    rmDataProduct: rmDataProduct((0, import_node_path22.join)(path8, "data-products")),
     /**
      * Remove a data product by its id
      * @param id - The id of the data product to remove
      * @param version - Optional version of the data product to remove
      */
-    rmDataProductById: rmDataProductById((0, import_node_path20.join)(path6)),
+    rmDataProductById: rmDataProductById((0, import_node_path22.join)(path8)),
     /**
      * Check to see if a data product version exists
      * @param id - The id of the data product
      * @param version - The version of the data product (supports semver)
      * @returns
      */
-    dataProductHasVersion: dataProductHasVersion((0, import_node_path20.join)(path6)),
+    dataProductHasVersion: dataProductHasVersion((0, import_node_path22.join)(path8)),
     /**
      * Adds a file to a data product by its id
      * @param id - The id of the data product to add the file to
@@ -3110,7 +3549,7 @@ var src_default = (path6) => {
      * @param version - Optional version of the data product to add the file to
      * @returns
      */
-    addFileToDataProduct: addFileToDataProduct((0, import_node_path20.join)(path6)),
+    addFileToDataProduct: addFileToDataProduct((0, import_node_path22.join)(path8)),
     /**
      * Adds a data product to a domain
      * @param id - The id of the domain
@@ -3118,7 +3557,7 @@ var src_default = (path6) => {
      * @param version - (Optional) The version of the domain to add the data product to
      * @returns
      */
-    addDataProductToDomain: addDataProductToDomain((0, import_node_path20.join)(path6, "domains")),
+    addDataProductToDomain: addDataProductToDomain((0, import_node_path22.join)(path8, "domains")),
     /**
      * ================================
      *            Diagrams
@@ -3130,13 +3569,13 @@ var src_default = (path6) => {
      * @param version - Optional id of the version to get (supports semver)
      * @returns Diagram|Undefined
      */
-    getDiagram: getDiagram((0, import_node_path20.join)(path6)),
+    getDiagram: getDiagram((0, import_node_path22.join)(path8)),
     /**
      * Returns all diagrams from EventCatalog
      * @param latestOnly - optional boolean, set to true to get only latest versions
      * @returns Diagram[]|Undefined
      */
-    getDiagrams: getDiagrams((0, import_node_path20.join)(path6)),
+    getDiagrams: getDiagrams((0, import_node_path22.join)(path8)),
     /**
      * Adds a diagram to EventCatalog
      *
@@ -3144,33 +3583,33 @@ var src_default = (path6) => {
      * @param options - Optional options to write the diagram
      *
      */
-    writeDiagram: writeDiagram((0, import_node_path20.join)(path6, "diagrams")),
+    writeDiagram: writeDiagram((0, import_node_path22.join)(path8, "diagrams")),
     /**
      * Remove a diagram from EventCatalog (modeled on the standard POSIX rm utility)
      *
      * @param path - The path to your diagram, e.g. `/ArchitectureDiagram`
      *
      */
-    rmDiagram: rmDiagram((0, import_node_path20.join)(path6, "diagrams")),
+    rmDiagram: rmDiagram((0, import_node_path22.join)(path8, "diagrams")),
     /**
      * Remove a diagram by a diagram id
      *
      * @param id - The id of the diagram you want to remove
      *
      */
-    rmDiagramById: rmDiagramById((0, import_node_path20.join)(path6)),
+    rmDiagramById: rmDiagramById((0, import_node_path22.join)(path8)),
     /**
      * Moves a given diagram id to the version directory
      * @param id - The id of the diagram to version
      */
-    versionDiagram: versionDiagram((0, import_node_path20.join)(path6)),
+    versionDiagram: versionDiagram((0, import_node_path22.join)(path8)),
     /**
      * Check to see if a diagram version exists
      * @param id - The id of the diagram
      * @param version - The version of the diagram (supports semver)
      * @returns
      */
-    diagramHasVersion: diagramHasVersion((0, import_node_path20.join)(path6)),
+    diagramHasVersion: diagramHasVersion((0, import_node_path22.join)(path8)),
     /**
      * Adds a file to the given diagram
      * @param id - The id of the diagram to add the file to
@@ -3178,7 +3617,7 @@ var src_default = (path6) => {
      * @param version - Optional version of the diagram to add the file to
      * @returns
      */
-    addFileToDiagram: addFileToDiagram((0, import_node_path20.join)(path6)),
+    addFileToDiagram: addFileToDiagram((0, import_node_path22.join)(path8)),
     /**
      * ================================
      *            DSL
@@ -3197,18 +3636,21 @@ var src_default = (path6) => {
      * const dsl = await sdk.toDSL(services, { type: 'service', hydrate: true });
      * ```
      */
-    toDSL: toDSL((0, import_node_path20.join)(path6), {
-      getEvent: getEvent((0, import_node_path20.join)(path6)),
-      getCommand: getCommand((0, import_node_path20.join)(path6)),
-      getQuery: getQuery((0, import_node_path20.join)(path6)),
-      getService: getService((0, import_node_path20.join)(path6)),
-      getServices: getServices((0, import_node_path20.join)(path6)),
-      getDomain: getDomain((0, import_node_path20.join)(path6, "domains")),
-      getChannel: getChannel((0, import_node_path20.join)(path6)),
-      getChannels: getChannels((0, import_node_path20.join)(path6)),
-      getContainer: getDataStore((0, import_node_path20.join)(path6)),
-      getTeam: getTeam((0, import_node_path20.join)(path6, "teams")),
-      getUser: getUser((0, import_node_path20.join)(path6, "users"))
+    createSnapshot: createSnapshot((0, import_node_path22.join)(path8)),
+    diffSnapshots: diffSnapshots((0, import_node_path22.join)(path8)),
+    listSnapshots: listSnapshots((0, import_node_path22.join)(path8)),
+    toDSL: toDSL((0, import_node_path22.join)(path8), {
+      getEvent: getEvent((0, import_node_path22.join)(path8)),
+      getCommand: getCommand((0, import_node_path22.join)(path8)),
+      getQuery: getQuery((0, import_node_path22.join)(path8)),
+      getService: getService((0, import_node_path22.join)(path8)),
+      getServices: getServices((0, import_node_path22.join)(path8)),
+      getDomain: getDomain((0, import_node_path22.join)(path8, "domains")),
+      getChannel: getChannel((0, import_node_path22.join)(path8)),
+      getChannels: getChannels((0, import_node_path22.join)(path8)),
+      getContainer: getDataStore((0, import_node_path22.join)(path8)),
+      getTeam: getTeam((0, import_node_path22.join)(path8, "teams")),
+      getUser: getUser((0, import_node_path22.join)(path8, "users"))
     })
   };
 };