@eventcatalog/sdk 2.11.0 → 2.12.0

package/dist/services.js

@@ -1,577 +0,0 @@
-"use strict";
-var __create = Object.create;
-var __defProp = Object.defineProperty;
-var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
-var __getOwnPropNames = Object.getOwnPropertyNames;
-var __getProtoOf = Object.getPrototypeOf;
-var __hasOwnProp = Object.prototype.hasOwnProperty;
-var __export = (target, all) => {
-  for (var name in all)
-    __defProp(target, name, { get: all[name], enumerable: true });
-};
-var __copyProps = (to, from, except, desc) => {
-  if (from && typeof from === "object" || typeof from === "function") {
-    for (let key of __getOwnPropNames(from))
-      if (!__hasOwnProp.call(to, key) && key !== except)
-        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
-  }
-  return to;
-};
-var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
-  // If the importer is in node compatibility mode or this is not an ESM
-  // file that has been converted to a CommonJS file using a Babel-
-  // compatible transform (i.e. "__esModule" has not been set), then set
-  // "default" to the CommonJS "module.exports" for node compatibility.
-  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
-  mod
-));
-var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
-
-// src/services.ts
-var services_exports = {};
-__export(services_exports, {
-  addDataStoreToService: () => addDataStoreToService,
-  addEntityToService: () => addEntityToService,
-  addFileToService: () => addFileToService,
-  addMessageToService: () => addMessageToService,
-  getService: () => getService,
-  getServiceByPath: () => getServiceByPath,
-  getServices: () => getServices,
-  getSpecificationFilesForService: () => getSpecificationFilesForService,
-  isService: () => isService,
-  rmService: () => rmService,
-  rmServiceById: () => rmServiceById,
-  serviceHasVersion: () => serviceHasVersion,
-  toService: () => toService,
-  versionService: () => versionService,
-  writeService: () => writeService,
-  writeServiceToDomain: () => writeServiceToDomain,
-  writeVersionedService: () => writeVersionedService
-});
-module.exports = __toCommonJS(services_exports);
-var import_promises2 = __toESM(require("fs/promises"));
-var import_node_path4 = require("path");
-
-// src/internal/resources.ts
-var import_path = require("path");
-
-// src/internal/utils.ts
-var import_glob = require("glob");
-var import_node_fs = __toESM(require("fs"));
-var import_fs_extra = require("fs-extra");
-var import_node_path = require("path");
-var import_gray_matter = __toESM(require("gray-matter"));
-var import_semver = require("semver");
-var versionExists = async (catalogDir, id, version) => {
-  const files = await getFiles(`${catalogDir}/**/index.{md,mdx}`);
-  const matchedFiles = await searchFilesForId(files, id, version) || [];
-  return matchedFiles.length > 0;
-};
-var findFileById = async (catalogDir, id, version) => {
-  const files = await getFiles(`${catalogDir}/**/index.{md,mdx}`);
-  const matchedFiles = await searchFilesForId(files, id) || [];
-  const latestVersion = matchedFiles.find((path2) => !path2.includes("versioned"));
-  if (!version) {
-    return latestVersion;
-  }
-  const parsedFiles = matchedFiles.map((path2) => {
-    const { data } = import_gray_matter.default.read(path2);
-    return { ...data, path: path2 };
-  });
-  if (version === "latest") {
-    return latestVersion;
-  }
-  const exactMatch = parsedFiles.find((c) => c.version === version);
-  if (exactMatch) {
-    return exactMatch.path;
-  }
-  const semverRange = (0, import_semver.validRange)(version);
-  if (semverRange) {
-    const match = parsedFiles.filter((c) => {
-      try {
-        return (0, import_semver.satisfies)(c.version, semverRange);
-      } catch (error) {
-        return false;
-      }
-    });
-    return match.length > 0 ? match[0].path : void 0;
-  }
-  return void 0;
-};
-var getFiles = async (pattern, ignore = "") => {
-  try {
-    const normalizedInputPattern = (0, import_node_path.normalize)(pattern);
-    const absoluteBaseDir = (0, import_node_path.resolve)(
-      normalizedInputPattern.includes("**") ? normalizedInputPattern.split("**")[0] : (0, import_node_path.dirname)(normalizedInputPattern)
-    );
-    let relativePattern = (0, import_node_path.relative)(absoluteBaseDir, normalizedInputPattern);
-    relativePattern = relativePattern.replace(/\\/g, "/");
-    const ignoreList = Array.isArray(ignore) ? ignore : [ignore];
-    const files = (0, import_glob.globSync)(relativePattern, {
-      cwd: absoluteBaseDir,
-      ignore: ["node_modules/**", ...ignoreList],
-      absolute: true,
-      nodir: true
-    });
-    return files.map(import_node_path.normalize);
-  } catch (error) {
-    const absoluteBaseDirForError = (0, import_node_path.resolve)(
-      (0, import_node_path.normalize)(pattern).includes("**") ? (0, import_node_path.normalize)(pattern).split("**")[0] : (0, import_node_path.dirname)((0, import_node_path.normalize)(pattern))
-    );
-    const relativePatternForError = (0, import_node_path.relative)(absoluteBaseDirForError, (0, import_node_path.normalize)(pattern)).replace(/\\/g, "/");
-    throw new Error(
-      `Error finding files for pattern "${pattern}" (using cwd: "${absoluteBaseDirForError}", globPattern: "${relativePatternForError}"): ${error.message}`
-    );
-  }
-};
-var searchFilesForId = async (files, id, version) => {
-  const escapedId = id.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
-  const idRegex = new RegExp(`^id:\\s*(['"]|>-)?\\s*${escapedId}['"]?\\s*$`, "m");
-  const versionRegex = new RegExp(`^version:\\s*['"]?${version}['"]?\\s*$`, "m");
-  const matches = files.map((file) => {
-    const content = import_node_fs.default.readFileSync(file, "utf-8");
-    const hasIdMatch = content.match(idRegex);
-    if (version && !content.match(versionRegex)) {
-      return void 0;
-    }
-    if (hasIdMatch) {
-      return file;
-    }
-  });
-  return matches.filter(Boolean).filter((file) => file !== void 0);
-};
-var copyDir = async (catalogDir, source, target, filter) => {
-  const tmpDirectory = (0, import_node_path.join)(catalogDir, "tmp");
-  import_node_fs.default.mkdirSync(tmpDirectory, { recursive: true });
-  await (0, import_fs_extra.copy)(source, tmpDirectory, {
-    overwrite: true,
-    filter
-  });
-  await (0, import_fs_extra.copy)(tmpDirectory, target, {
-    overwrite: true,
-    filter
-  });
-  import_node_fs.default.rmSync(tmpDirectory, { recursive: true });
-};
-var uniqueVersions = (messages) => {
-  const uniqueSet = /* @__PURE__ */ new Set();
-  return messages.filter((message) => {
-    const key = `${message.id}-${message.version}`;
-    if (!uniqueSet.has(key)) {
-      uniqueSet.add(key);
-      return true;
-    }
-    return false;
-  });
-};
-
-// src/internal/resources.ts
-var import_gray_matter2 = __toESM(require("gray-matter"));
-var import_promises = __toESM(require("fs/promises"));
-var import_node_fs2 = __toESM(require("fs"));
-var import_semver2 = require("semver");
-var import_proper_lockfile = require("proper-lockfile");
-var import_node_path2 = require("path");
-var import_node_path3 = __toESM(require("path"));
-var versionResource = async (catalogDir, id) => {
-  const files = await getFiles(`${catalogDir}/**/index.{md,mdx}`);
-  const matchedFiles = await searchFilesForId(files, id);
-  if (matchedFiles.length === 0) {
-    throw new Error(`No resource found with id: ${id}`);
-  }
-  const file = matchedFiles[0];
-  const sourceDirectory = (0, import_path.dirname)(file).replace(/[/\\]versioned[/\\][^/\\]+[/\\]/, import_node_path3.default.sep);
-  const { data: { version = "0.0.1" } = {} } = import_gray_matter2.default.read(file);
-  const targetDirectory = getVersionedDirectory(sourceDirectory, version);
-  import_node_fs2.default.mkdirSync(targetDirectory, { recursive: true });
-  const ignoreListToCopy = ["events", "commands", "queries", "versioned"];
-  await copyDir(catalogDir, sourceDirectory, targetDirectory, (src) => {
-    const folderName = (0, import_node_path2.basename)(src);
-    if (ignoreListToCopy.includes(folderName)) {
-      return false;
-    }
-    return true;
-  });
-  await import_promises.default.readdir(sourceDirectory).then(async (resourceFiles) => {
-    await Promise.all(
-      resourceFiles.map(async (file2) => {
-        if (ignoreListToCopy.includes(file2)) {
-          return;
-        }
-        if (file2 !== "versioned") {
-          import_node_fs2.default.rmSync((0, import_path.join)(sourceDirectory, file2), { recursive: true });
-        }
-      })
-    );
-  });
-};
-var writeResource = async (catalogDir, resource, options = {
-  path: "",
-  type: "",
-  override: false,
-  versionExistingContent: false,
-  format: "mdx"
-}) => {
-  const path2 = options.path || `/${resource.id}`;
-  const fullPath = (0, import_path.join)(catalogDir, path2);
-  const format = options.format || "mdx";
-  import_node_fs2.default.mkdirSync(fullPath, { recursive: true });
-  const lockPath = (0, import_path.join)(fullPath, `index.${format}`);
-  if (!import_node_fs2.default.existsSync(lockPath)) {
-    import_node_fs2.default.writeFileSync(lockPath, "");
-  }
-  try {
-    await (0, import_proper_lockfile.lock)(lockPath, {
-      retries: 5,
-      stale: 1e4
-      // 10 seconds
-    });
-    const exists = await versionExists(catalogDir, resource.id, resource.version);
-    if (exists && !options.override) {
-      throw new Error(`Failed to write ${resource.id} (${options.type}) as the version ${resource.version} already exists`);
-    }
-    const { markdown, ...frontmatter } = resource;
-    if (options.versionExistingContent && !exists) {
-      const currentResource = await getResource(catalogDir, resource.id);
-      if (currentResource) {
-        if ((0, import_semver2.satisfies)(resource.version, `>${currentResource.version}`)) {
-          await versionResource(catalogDir, resource.id);
-        } else {
-          throw new Error(`New version ${resource.version} is not greater than current version ${currentResource.version}`);
-        }
-      }
-    }
-    const document = import_gray_matter2.default.stringify(markdown.trim(), frontmatter);
-    import_node_fs2.default.writeFileSync(lockPath, document);
-  } finally {
-    await (0, import_proper_lockfile.unlock)(lockPath).catch(() => {
-    });
-  }
-};
-var getResource = async (catalogDir, id, version, options, filePath) => {
-  const attachSchema = options?.attachSchema || false;
-  const file = filePath || (id ? await findFileById(catalogDir, id, version) : void 0);
-  if (!file || !import_node_fs2.default.existsSync(file)) return;
-  const { data, content } = import_gray_matter2.default.read(file);
-  if (attachSchema && data?.schemaPath) {
-    const resourceDirectory = (0, import_path.dirname)(file);
-    const pathToSchema = (0, import_path.join)(resourceDirectory, data.schemaPath);
-    if (import_node_fs2.default.existsSync(pathToSchema)) {
-      const schema = import_node_fs2.default.readFileSync(pathToSchema, "utf8");
-      try {
-        data.schema = JSON.parse(schema);
-      } catch (error) {
-        data.schema = schema;
-      }
-    }
-  }
-  return {
-    ...data,
-    markdown: content.trim()
-  };
-};
-var getResourcePath = async (catalogDir, id, version) => {
-  const file = await findFileById(catalogDir, id, version);
-  if (!file) return;
-  return {
-    fullPath: file,
-    relativePath: file.replace(catalogDir, ""),
-    directory: (0, import_path.dirname)(file.replace(catalogDir, ""))
-  };
-};
-var toResource = async (catalogDir, rawContents) => {
-  const { data, content } = (0, import_gray_matter2.default)(rawContents);
-  return {
-    ...data,
-    markdown: content.trim()
-  };
-};
-var getResources = async (catalogDir, {
-  type,
-  latestOnly = false,
-  ignore = [],
-  pattern = "",
-  attachSchema = false
-}) => {
-  const ignoreList = latestOnly ? `**/versioned/**` : "";
-  const filePattern = pattern || `${catalogDir}/**/${type}/**/index.{md,mdx}`;
-  const files = await getFiles(filePattern, [ignoreList, ...ignore]);
-  if (files.length === 0) return;
-  return files.map((file) => {
-    const { data, content } = import_gray_matter2.default.read(file);
-    if (attachSchema && data?.schemaPath) {
-      const resourceDirectory = (0, import_path.dirname)(file);
-      const pathToSchema = (0, import_path.join)(resourceDirectory, data.schemaPath);
-      if (import_node_fs2.default.existsSync(pathToSchema)) {
-        const schema = import_node_fs2.default.readFileSync(pathToSchema, "utf8");
-        try {
-          data.schema = JSON.parse(schema);
-        } catch (error) {
-          data.schema = schema;
-        }
-      }
-    }
-    return {
-      ...data,
-      markdown: content.trim()
-    };
-  });
-};
-var rmResourceById = async (catalogDir, id, version, options) => {
-  const files = await getFiles(`${catalogDir}/**/index.{md,mdx}`);
-  const matchedFiles = await searchFilesForId(files, id, version);
-  if (matchedFiles.length === 0) {
-    throw new Error(`No ${options?.type || "resource"} found with id: ${id}`);
-  }
-  if (options?.persistFiles) {
-    await Promise.all(
-      matchedFiles.map(async (file) => {
-        await import_promises.default.rm(file, { recursive: true });
-        await waitForFileRemoval(file);
-      })
-    );
-  } else {
-    await Promise.all(
-      matchedFiles.map(async (file) => {
-        const directory = (0, import_path.dirname)(file);
-        await import_promises.default.rm(directory, { recursive: true, force: true });
-        await waitForFileRemoval(directory);
-      })
-    );
-  }
-};
-var waitForFileRemoval = async (path2, maxRetries = 50, delay = 10) => {
-  for (let i = 0; i < maxRetries; i++) {
-    try {
-      await import_promises.default.access(path2);
-      await new Promise((resolve2) => setTimeout(resolve2, delay));
-    } catch (error) {
-      return;
-    }
-  }
-  throw new Error(`File/directory ${path2} was not removed after ${maxRetries} attempts`);
-};
-var addFileToResource = async (catalogDir, id, file, version, options) => {
-  let pathToResource;
-  if (options?.path) {
-    pathToResource = (0, import_path.join)(catalogDir, options.path, "index.mdx");
-  } else {
-    pathToResource = await findFileById(catalogDir, id, version);
-  }
-  if (!pathToResource) throw new Error("Cannot find directory to write file to");
-  import_node_fs2.default.mkdirSync(import_node_path3.default.dirname(pathToResource), { recursive: true });
-  let fileContent = file.content.trim();
-  try {
-    const json = JSON.parse(fileContent);
-    fileContent = JSON.stringify(json, null, 2);
-  } catch (error) {
-  }
-  import_node_fs2.default.writeFileSync((0, import_path.join)((0, import_path.dirname)(pathToResource), file.fileName), fileContent);
-};
-var getFileFromResource = async (catalogDir, id, file, version) => {
-  const pathToResource = await findFileById(catalogDir, id, version);
-  if (!pathToResource) throw new Error("Cannot find directory of resource");
-  const exists = await import_promises.default.access((0, import_path.join)((0, import_path.dirname)(pathToResource), file.fileName)).then(() => true).catch(() => false);
-  if (!exists) throw new Error(`File ${file.fileName} does not exist in resource ${id} v(${version})`);
-  return import_node_fs2.default.readFileSync((0, import_path.join)((0, import_path.dirname)(pathToResource), file.fileName), "utf-8");
-};
-var getVersionedDirectory = (sourceDirectory, version) => {
-  return (0, import_path.join)(sourceDirectory, "versioned", version);
-};
-
-// src/services.ts
-var getService = (directory) => async (id, version) => getResource(directory, id, version, { type: "service" });
-var getServiceByPath = (directory) => async (path2) => {
-  const service = await getResource(directory, void 0, void 0, { type: "service" }, path2);
-  return service;
-};
-var getServices = (directory) => async (options) => getResources(directory, {
-  type: "services",
-  ignore: ["**/events/**", "**/commands/**", "**/queries/**", "**/entities/**", "**/subdomains/**/entities/**"],
-  ...options
-});
-var writeService = (directory) => async (service, options = {
-  path: "",
-  override: false,
-  format: "mdx"
-}) => {
-  const resource = { ...service };
-  if (Array.isArray(service.sends)) {
-    resource.sends = uniqueVersions(service.sends);
-  }
-  if (Array.isArray(service.receives)) {
-    resource.receives = uniqueVersions(service.receives);
-  }
-  return await writeResource(directory, resource, { ...options, type: "service" });
-};
-var writeVersionedService = (directory) => async (service) => {
-  const resource = { ...service };
-  const path2 = getVersionedDirectory(service.id, service.version);
-  return await writeService(directory)(resource, { path: path2 });
-};
-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`;
-  pathForService = (0, import_node_path4.join)(pathForService, service.id);
-  await writeResource(directory, { ...service }, { ...options, path: pathForService, type: "service" });
-};
-var versionService = (directory) => async (id) => versionResource(directory, id);
-var rmService = (directory) => async (path2) => {
-  await import_promises2.default.rm((0, import_node_path4.join)(directory, path2), { recursive: true });
-};
-var rmServiceById = (directory) => async (id, version, persistFiles) => {
-  await rmResourceById(directory, id, version, { type: "service", persistFiles });
-};
-var addFileToService = (directory) => async (id, file, version) => addFileToResource(directory, id, file, version);
-var getSpecificationFilesForService = (directory) => async (id, version) => {
-  let service = await getService(directory)(id, version);
-  const filePathToService = await findFileById(directory, id, version);
-  if (!filePathToService) throw new Error("Cannot find directory of service");
-  let specs = [];
-  if (service.specifications) {
-    const serviceSpecifications = service.specifications;
-    let specificationFiles;
-    if (Array.isArray(serviceSpecifications)) {
-      specificationFiles = serviceSpecifications.map((spec) => ({ key: spec.type, path: spec.path }));
-    } else {
-      specificationFiles = Object.keys(serviceSpecifications).map((spec) => ({
-        key: spec,
-        path: serviceSpecifications[spec]
-      }));
-    }
-    const getSpecs = specificationFiles.map(async ({ key, path: fileName }) => {
-      if (!fileName) {
-        throw new Error(`Specification file name for ${fileName} is undefined`);
-      }
-      const rawFile = await getFileFromResource(directory, id, { fileName }, version);
-      return { key, content: rawFile, fileName, path: (0, import_node_path4.join)((0, import_node_path4.dirname)(filePathToService), fileName) };
-    });
-    specs = await Promise.all(getSpecs);
-  }
-  return specs;
-};
-var addMessageToService = (directory) => async (id, direction, event, version) => {
-  let service = await getService(directory)(id, version);
-  const servicePath = await getResourcePath(directory, id, version);
-  const extension = (0, import_node_path4.extname)(servicePath?.fullPath || "");
-  if (direction === "sends") {
-    if (service.sends === void 0) {
-      service.sends = [];
-    }
-    for (let i = 0; i < service.sends.length; i++) {
-      if (service.sends[i].id === event.id && service.sends[i].version === event.version) {
-        return;
-      }
-    }
-    service.sends.push({ id: event.id, version: event.version });
-  } else if (direction === "receives") {
-    if (service.receives === void 0) {
-      service.receives = [];
-    }
-    for (let i = 0; i < service.receives.length; i++) {
-      if (service.receives[i].id === event.id && service.receives[i].version === event.version) {
-        return;
-      }
-    }
-    service.receives.push({ id: event.id, version: event.version });
-  } else {
-    throw new Error(`Direction ${direction} is invalid, only 'receives' and 'sends' are supported`);
-  }
-  const existingResource = await findFileById(directory, id, version);
-  if (!existingResource) {
-    throw new Error(`Cannot find service ${id} in the catalog`);
-  }
-  const path2 = existingResource.split(/[\\/]+services/)[0];
-  const pathToResource = (0, import_node_path4.join)(path2, "services");
-  await rmServiceById(directory)(id, version);
-  await writeService(pathToResource)(service, { format: extension === ".md" ? "md" : "mdx" });
-};
-var serviceHasVersion = (directory) => async (id, version) => {
-  const file = await findFileById(directory, id, version);
-  return !!file;
-};
-var isService = (directory) => async (path2) => {
-  const service = await getServiceByPath(directory)(path2);
-  const relativePath = (0, import_node_path4.relative)(directory, path2);
-  const segments = relativePath.split(/[/\\]+/);
-  return !!service && segments.includes("services");
-};
-var toService = (directory) => async (file) => toResource(directory, file);
-var addEntityToService = (directory) => async (id, entity, version) => {
-  let service = await getService(directory)(id, version);
-  const servicePath = await getResourcePath(directory, id, version);
-  const extension = (0, import_node_path4.extname)(servicePath?.fullPath || "");
-  if (service.entities === void 0) {
-    service.entities = [];
-  }
-  for (let i = 0; i < service.entities.length; i++) {
-    if (service.entities[i].id === entity.id && service.entities[i].version === entity.version) {
-      return;
-    }
-  }
-  service.entities.push({ id: entity.id, version: entity.version });
-  const existingResource = await findFileById(directory, id, version);
-  if (!existingResource) {
-    throw new Error(`Cannot find service ${id} in the catalog`);
-  }
-  const path2 = existingResource.split(/[\\/]+services/)[0];
-  const pathToResource = (0, import_node_path4.join)(path2, "services");
-  await rmServiceById(directory)(id, version);
-  await writeService(pathToResource)(service, { format: extension === ".md" ? "md" : "mdx" });
-};
-var addDataStoreToService = (directory) => async (id, operation, dataStore, version) => {
-  let service = await getService(directory)(id, version);
-  const servicePath = await getResourcePath(directory, id, version);
-  const extension = (0, import_node_path4.extname)(servicePath?.fullPath || "");
-  if (operation === "writesTo") {
-    if (service.writesTo === void 0) {
-      service.writesTo = [];
-    }
-    for (let i = 0; i < service.writesTo.length; i++) {
-      if (service.writesTo[i].id === dataStore.id && service.writesTo[i].version === dataStore.version) {
-        return;
-      }
-    }
-    service.writesTo.push({ id: dataStore.id, version: dataStore.version });
-  } else if (operation === "readsFrom") {
-    if (service.readsFrom === void 0) {
-      service.readsFrom = [];
-    }
-    for (let i = 0; i < service.readsFrom.length; i++) {
-      if (service.readsFrom[i].id === dataStore.id && service.readsFrom[i].version === dataStore.version) {
-        return;
-      }
-    }
-    service.readsFrom.push({ id: dataStore.id, version: dataStore.version });
-  } else {
-    throw new Error(`Operation ${operation} is invalid, only 'writesTo' and 'readsFrom' are supported`);
-  }
-  const existingResource = await findFileById(directory, id, version);
-  if (!existingResource) {
-    throw new Error(`Cannot find service ${id} in the catalog`);
-  }
-  const path2 = existingResource.split(/[\\/]+services/)[0];
-  const pathToResource = (0, import_node_path4.join)(path2, "services");
-  await rmServiceById(directory)(id, version);
-  await writeService(pathToResource)(service, { format: extension === ".md" ? "md" : "mdx" });
-};
-// Annotate the CommonJS export names for ESM import in node:
-0 && (module.exports = {
-  addDataStoreToService,
-  addEntityToService,
-  addFileToService,
-  addMessageToService,
-  getService,
-  getServiceByPath,
-  getServices,
-  getSpecificationFilesForService,
-  isService,
-  rmService,
-  rmServiceById,
-  serviceHasVersion,
-  toService,
-  versionService,
-  writeService,
-  writeServiceToDomain,
-  writeVersionedService
-});
-//# sourceMappingURL=services.js.map