@eventcatalog/sdk 2.18.0 → 2.18.1

package/dist/index.d.mts

@@ -1320,7 +1320,25 @@ declare const _default: (path: string) => {
     addEventToDomain: (id: string, direction: string, message: {
         id: string;
         version: string;
-        fields?: string[];
+        fields? /**
+         * Add an event to a service by it's id.
+         *
+         * Optionally specify a version to add the event to a specific version of the service.
+         *
+         * @example
+         * ```ts
+         * import utils from '@eventcatalog/utils';
+         *
+         * const { addEventToService } = utils('/path/to/eventcatalog');
+         *
+         * // adds a new event (InventoryUpdatedEvent) that the InventoryService will send
+         * await addEventToService('InventoryService', 'sends', { event: 'InventoryUpdatedEvent', version: '2.0.0' });
+         *
+         * // adds a new event (OrderComplete) that the InventoryService will receive
+         * await addEventToService('InventoryService', 'receives', { event: 'OrderComplete', version: '2.0.0' });
+         *
+         * ```
+         */: string[];
     }, version?: string) => Promise<void>;
     /**
      * Add a command to a domain by its id.
@@ -1342,7 +1360,25 @@ declare const _default: (path: string) => {
     addCommandToDomain: (id: string, direction: string, message: {
         id: string;
         version: string;
-        fields?: string[];
+        fields? /**
+         * Add an event to a service by it's id.
+         *
+         * Optionally specify a version to add the event to a specific version of the service.
+         *
+         * @example
+         * ```ts
+         * import utils from '@eventcatalog/utils';
+         *
+         * const { addEventToService } = utils('/path/to/eventcatalog');
+         *
+         * // adds a new event (InventoryUpdatedEvent) that the InventoryService will send
+         * await addEventToService('InventoryService', 'sends', { event: 'InventoryUpdatedEvent', version: '2.0.0' });
+         *
+         * // adds a new event (OrderComplete) that the InventoryService will receive
+         * await addEventToService('InventoryService', 'receives', { event: 'OrderComplete', version: '2.0.0' });
+         *
+         * ```
+         */: string[];
     }, version?: string) => Promise<void>;
     /**
      * Add a query to a domain by its id.
@@ -1364,7 +1400,25 @@ declare const _default: (path: string) => {
     addQueryToDomain: (id: string, direction: string, message: {
         id: string;
         version: string;
-        fields?: string[];
+        fields? /**
+         * Add an event to a service by it's id.
+         *
+         * Optionally specify a version to add the event to a specific version of the service.
+         *
+         * @example
+         * ```ts
+         * import utils from '@eventcatalog/utils';
+         *
+         * const { addEventToService } = utils('/path/to/eventcatalog');
+         *
+         * // adds a new event (InventoryUpdatedEvent) that the InventoryService will send
+         * await addEventToService('InventoryService', 'sends', { event: 'InventoryUpdatedEvent', version: '2.0.0' });
+         *
+         * // adds a new event (OrderComplete) that the InventoryService will receive
+         * await addEventToService('InventoryService', 'receives', { event: 'OrderComplete', version: '2.0.0' });
+         *
+         * ```
+         */: string[];
     }, version?: string) => Promise<void>;
     /**
      * ================================

package/dist/index.d.ts

@@ -1320,7 +1320,25 @@ declare const _default: (path: string) => {
     addEventToDomain: (id: string, direction: string, message: {
         id: string;
         version: string;
-        fields?: string[];
+        fields? /**
+         * Add an event to a service by it's id.
+         *
+         * Optionally specify a version to add the event to a specific version of the service.
+         *
+         * @example
+         * ```ts
+         * import utils from '@eventcatalog/utils';
+         *
+         * const { addEventToService } = utils('/path/to/eventcatalog');
+         *
+         * // adds a new event (InventoryUpdatedEvent) that the InventoryService will send
+         * await addEventToService('InventoryService', 'sends', { event: 'InventoryUpdatedEvent', version: '2.0.0' });
+         *
+         * // adds a new event (OrderComplete) that the InventoryService will receive
+         * await addEventToService('InventoryService', 'receives', { event: 'OrderComplete', version: '2.0.0' });
+         *
+         * ```
+         */: string[];
     }, version?: string) => Promise<void>;
     /**
      * Add a command to a domain by its id.
@@ -1342,7 +1360,25 @@ declare const _default: (path: string) => {
     addCommandToDomain: (id: string, direction: string, message: {
         id: string;
         version: string;
-        fields?: string[];
+        fields? /**
+         * Add an event to a service by it's id.
+         *
+         * Optionally specify a version to add the event to a specific version of the service.
+         *
+         * @example
+         * ```ts
+         * import utils from '@eventcatalog/utils';
+         *
+         * const { addEventToService } = utils('/path/to/eventcatalog');
+         *
+         * // adds a new event (InventoryUpdatedEvent) that the InventoryService will send
+         * await addEventToService('InventoryService', 'sends', { event: 'InventoryUpdatedEvent', version: '2.0.0' });
+         *
+         * // adds a new event (OrderComplete) that the InventoryService will receive
+         * await addEventToService('InventoryService', 'receives', { event: 'OrderComplete', version: '2.0.0' });
+         *
+         * ```
+         */: string[];
     }, version?: string) => Promise<void>;
     /**
      * Add a query to a domain by its id.
@@ -1364,7 +1400,25 @@ declare const _default: (path: string) => {
     addQueryToDomain: (id: string, direction: string, message: {
         id: string;
         version: string;
-        fields?: string[];
+        fields? /**
+         * Add an event to a service by it's id.
+         *
+         * Optionally specify a version to add the event to a specific version of the service.
+         *
+         * @example
+         * ```ts
+         * import utils from '@eventcatalog/utils';
+         *
+         * const { addEventToService } = utils('/path/to/eventcatalog');
+         *
+         * // adds a new event (InventoryUpdatedEvent) that the InventoryService will send
+         * await addEventToService('InventoryService', 'sends', { event: 'InventoryUpdatedEvent', version: '2.0.0' });
+         *
+         * // adds a new event (OrderComplete) that the InventoryService will receive
+         * await addEventToService('InventoryService', 'receives', { event: 'OrderComplete', version: '2.0.0' });
+         *
+         * ```
+         */: string[];
     }, version?: string) => Promise<void>;
     /**
      * ================================

package/dist/index.js

@@ -1467,6 +1467,14 @@ var import_promises6 = __toESM(require("fs/promises"));
 var import_node_path8 = __toESM(require("path"));
 var import_node_fs3 = __toESM(require("fs"));
 var import_gray_matter3 = __toESM(require("gray-matter"));
+var resolveDomainWriteDirectory = async (directory, id, version) => {
+  const existingResource = await findFileById(directory, id, version);
+  if (!existingResource) return directory;
+  const normalizedPath = existingResource.replace(/\\/g, "/");
+  const lastDomainsIndex = normalizedPath.lastIndexOf("/domains/");
+  if (lastDomainsIndex === -1) return directory;
+  return existingResource.substring(0, lastDomainsIndex + "/domains".length);
+};
 var getDomain = (directory) => async (id, version) => getResource(directory, id, version, { type: "domain" });
 var getDomains = (directory) => async (options) => getResources(directory, {
   type: "domains",
@@ -1536,8 +1544,9 @@ var addServiceToDomain = (directory) => async (id, service, version) => {
     return;
   }
   domain.services.push(service);
+  const writeDir = await resolveDomainWriteDirectory(directory, id, version);
   await rmDomainById(directory)(id, version, true);
-  await writeDomain(directory)(domain, { format: extension === ".md" ? "md" : "mdx" });
+  await writeDomain(writeDir)(domain, { format: extension === ".md" ? "md" : "mdx" });
 };
 var addSubDomainToDomain = (directory) => async (id, subDomain, version) => {
   let domain = await getDomain(directory)(id, version);
@@ -1551,8 +1560,9 @@ var addSubDomainToDomain = (directory) => async (id, subDomain, version) => {
     return;
   }
   domain.domains.push(subDomain);
+  const writeDir = await resolveDomainWriteDirectory(directory, id, version);
   await rmDomainById(directory)(id, version, true);
-  await writeDomain(directory)(domain, { format: extension === ".md" ? "md" : "mdx" });
+  await writeDomain(writeDir)(domain, { format: extension === ".md" ? "md" : "mdx" });
 };
 var addEntityToDomain = (directory) => async (id, entity, version) => {
   let domain = await getDomain(directory)(id, version);
@@ -1566,8 +1576,9 @@ var addEntityToDomain = (directory) => async (id, entity, version) => {
     return;
   }
   domain.entities.push(entity);
+  const writeDir = await resolveDomainWriteDirectory(directory, id, version);
   await rmDomainById(directory)(id, version, true);
-  await writeDomain(directory)(domain, { format: extension === ".md" ? "md" : "mdx" });
+  await writeDomain(writeDir)(domain, { format: extension === ".md" ? "md" : "mdx" });
 };
 var addDataProductToDomain = (directory) => async (id, dataProduct, version) => {
   let domain = await getDomain(directory)(id, version);
@@ -1583,8 +1594,9 @@ var addDataProductToDomain = (directory) => async (id, dataProduct, version) =>
     return;
   }
   domain.dataProducts.push(dataProduct);
+  const writeDir = await resolveDomainWriteDirectory(directory, id, version);
   await rmDomainById(directory)(id, version, true);
-  await writeDomain(directory)(domain, { format: extension === ".md" ? "md" : "mdx" });
+  await writeDomain(writeDir)(domain, { format: extension === ".md" ? "md" : "mdx" });
 };
 var addMessageToDomain = (directory) => async (id, direction, message, version) => {
   let domain = await getDomain(directory)(id, version);
@@ -1613,15 +1625,9 @@ var addMessageToDomain = (directory) => async (id, direction, message, version)
   } else {
     throw new Error(`Direction ${direction} is invalid, only 'receives' and 'sends' are supported`);
   }
-  const existingResource = await findFileById(directory, id, version);
-  if (!existingResource) {
-    throw new Error(`Cannot find domain ${id} in the catalog`);
-  }
-  const normalizedPath = existingResource.replace(/\\/g, "/");
-  const lastDomainsIndex = normalizedPath.lastIndexOf("/domains/");
-  const pathToResource = existingResource.substring(0, lastDomainsIndex + "/domains".length);
+  const writeDir = await resolveDomainWriteDirectory(directory, id, version);
   await rmDomainById(directory)(id, version, true);
-  await writeDomain(pathToResource)(domain, { format: extension === ".md" ? "md" : "mdx" });
+  await writeDomain(writeDir)(domain, { format: extension === ".md" ? "md" : "mdx" });
 };
 
 // src/channels.ts