@eventcatalog/sdk 2.17.2 → 2.17.4

package/dist/index.d.mts

@@ -473,7 +473,11 @@ declare const _default: (path: string) => {
      *
      */
     writeEvent: (event: Event, options?: {
-        path?: string;
+        path? /**
+         * Returns all events from EventCatalog
+         * @param latestOnly - optional boolean, set to true to get only latest versions
+         * @returns Event[]|Undefined
+         */: string;
         override?: boolean;
         versionExistingContent?: boolean;
         format?: "md" | "mdx";
@@ -490,7 +494,12 @@ declare const _default: (path: string) => {
         id: string;
         version?: string;
     }, options?: {
-        path?: string;
+        path? /**
+         * Remove an event by an Event id
+         *
+         * @param id - The id of the event you want to remove
+         *
+         */: string;
         format?: "md" | "mdx";
         override?: boolean;
     }) => Promise<void>;
@@ -546,6 +555,15 @@ declare const _default: (path: string) => {
      * @returns
      */
     eventHasVersion: (id: string, version?: string) => Promise<boolean>;
+    addExampleToEvent: (id: string, example: {
+        content: string;
+        fileName: string;
+    }, version?: string) => Promise<void>;
+    getExamplesFromEvent: (id: string, version?: string) => Promise<{
+        fileName: string;
+        content: string;
+    }[]>;
+    removeExampleFromEvent: (id: string, fileName: string, version?: string) => Promise<void>;
     /**
      * ================================
      *            Commands
@@ -650,6 +668,15 @@ declare const _default: (path: string) => {
      * @returns
      */
     commandHasVersion: (id: string, version?: string) => Promise<boolean>;
+    addExampleToCommand: (id: string, example: {
+        content: string;
+        fileName: string;
+    }, version?: string) => Promise<void>;
+    getExamplesFromCommand: (id: string, version?: string) => Promise<{
+        fileName: string;
+        content: string;
+    }[]>;
+    removeExampleFromCommand: (id: string, fileName: string, version?: string) => Promise<void>;
     /**
      * ================================
      *            Queries
@@ -754,6 +781,15 @@ declare const _default: (path: string) => {
      * @returns
      */
     queryHasVersion: (id: string, version?: string) => Promise<boolean>;
+    addExampleToQuery: (id: string, example: {
+        content: string;
+        fileName: string;
+    }, version?: string) => Promise<void>;
+    getExamplesFromQuery: (id: string, version?: string) => Promise<{
+        fileName: string;
+        content: string;
+    }[]>;
+    removeExampleFromQuery: (id: string, fileName: string, version?: string) => Promise<void>;
     /**
      * ================================
      *            Channels
@@ -1678,7 +1714,11 @@ declare const _default: (path: string) => {
         version?: string;
     }, options?: {
         path?: string;
-        format?: "md" | "mdx";
+        format? /**
+         * Returns all commands from EventCatalog
+         * @param latestOnly - optional boolean, set to true to get only latest versions
+         * @returns Command[]|Undefined
+         */: "md" | "mdx";
         override?: boolean;
     }) => Promise<void>;
     /**

package/dist/index.d.ts

@@ -473,7 +473,11 @@ declare const _default: (path: string) => {
      *
      */
     writeEvent: (event: Event, options?: {
-        path?: string;
+        path? /**
+         * Returns all events from EventCatalog
+         * @param latestOnly - optional boolean, set to true to get only latest versions
+         * @returns Event[]|Undefined
+         */: string;
         override?: boolean;
         versionExistingContent?: boolean;
         format?: "md" | "mdx";
@@ -490,7 +494,12 @@ declare const _default: (path: string) => {
         id: string;
         version?: string;
     }, options?: {
-        path?: string;
+        path? /**
+         * Remove an event by an Event id
+         *
+         * @param id - The id of the event you want to remove
+         *
+         */: string;
         format?: "md" | "mdx";
         override?: boolean;
     }) => Promise<void>;
@@ -546,6 +555,15 @@ declare const _default: (path: string) => {
      * @returns
      */
     eventHasVersion: (id: string, version?: string) => Promise<boolean>;
+    addExampleToEvent: (id: string, example: {
+        content: string;
+        fileName: string;
+    }, version?: string) => Promise<void>;
+    getExamplesFromEvent: (id: string, version?: string) => Promise<{
+        fileName: string;
+        content: string;
+    }[]>;
+    removeExampleFromEvent: (id: string, fileName: string, version?: string) => Promise<void>;
     /**
      * ================================
      *            Commands
@@ -650,6 +668,15 @@ declare const _default: (path: string) => {
      * @returns
      */
     commandHasVersion: (id: string, version?: string) => Promise<boolean>;
+    addExampleToCommand: (id: string, example: {
+        content: string;
+        fileName: string;
+    }, version?: string) => Promise<void>;
+    getExamplesFromCommand: (id: string, version?: string) => Promise<{
+        fileName: string;
+        content: string;
+    }[]>;
+    removeExampleFromCommand: (id: string, fileName: string, version?: string) => Promise<void>;
     /**
      * ================================
      *            Queries
@@ -754,6 +781,15 @@ declare const _default: (path: string) => {
      * @returns
      */
     queryHasVersion: (id: string, version?: string) => Promise<boolean>;
+    addExampleToQuery: (id: string, example: {
+        content: string;
+        fileName: string;
+    }, version?: string) => Promise<void>;
+    getExamplesFromQuery: (id: string, version?: string) => Promise<{
+        fileName: string;
+        content: string;
+    }[]>;
+    removeExampleFromQuery: (id: string, fileName: string, version?: string) => Promise<void>;
     /**
      * ================================
      *            Channels
@@ -1678,7 +1714,11 @@ declare const _default: (path: string) => {
         version?: string;
     }, options?: {
         path?: string;
-        format?: "md" | "mdx";
+        format? /**
+         * Returns all commands from EventCatalog
+         * @param latestOnly - optional boolean, set to true to get only latest versions
+         * @returns Command[]|Undefined
+         */: "md" | "mdx";
         override?: boolean;
     }) => Promise<void>;
     /**

package/dist/index.js

@@ -1096,6 +1096,55 @@ var getFileFromResource = async (catalogDir, id, file, version) => {
 var getVersionedDirectory = (sourceDirectory, version) => {
   return (0, import_path.join)(sourceDirectory, "versioned", version);
 };
+var CONFIG_FILES = ["examples.config.yaml", "examples.config.yml", "examples.config.json"];
+function resolveExamplePath(examplesDir, fileName) {
+  const resolved = import_node_path3.default.resolve(examplesDir, fileName);
+  if (!resolved.startsWith(import_node_path3.default.resolve(examplesDir) + import_node_path3.default.sep) && resolved !== import_node_path3.default.resolve(examplesDir)) {
+    throw new Error(`Invalid example fileName: path traversal detected in "${fileName}"`);
+  }
+  return resolved;
+}
+var addExampleToResource = async (catalogDir, id, example, version) => {
+  const pathToResource = await findFileById(catalogDir, id, version);
+  if (!pathToResource) throw new Error("Cannot find directory to write example to");
+  const examplesDir = (0, import_path.join)((0, import_path.dirname)(pathToResource), "examples");
+  const targetPath = resolveExamplePath(examplesDir, example.fileName);
+  import_node_fs2.default.mkdirSync(import_node_path3.default.dirname(targetPath), { recursive: true });
+  import_node_fs2.default.writeFileSync(targetPath, example.content);
+};
+var getExamplesFromResource = async (catalogDir, id, version) => {
+  const pathToResource = await findFileById(catalogDir, id, version);
+  if (!pathToResource) throw new Error("Cannot find resource");
+  const examplesDir = (0, import_path.join)((0, import_path.dirname)(pathToResource), "examples");
+  if (!import_node_fs2.default.existsSync(examplesDir)) return [];
+  const collectFiles = (dir, baseDir) => {
+    const results = [];
+    const entries = import_node_fs2.default.readdirSync(dir, { withFileTypes: true });
+    for (const entry of entries) {
+      const fullPath = (0, import_path.join)(dir, entry.name);
+      if (entry.isDirectory()) {
+        results.push(...collectFiles(fullPath, baseDir));
+      } else if (entry.isFile() && !CONFIG_FILES.includes(entry.name)) {
+        results.push({
+          fileName: import_node_path3.default.relative(baseDir, fullPath),
+          content: import_node_fs2.default.readFileSync(fullPath, "utf-8")
+        });
+      }
+    }
+    return results;
+  };
+  return collectFiles(examplesDir, examplesDir).sort((a, b) => a.fileName.localeCompare(b.fileName));
+};
+var removeExampleFromResource = async (catalogDir, id, fileName, version) => {
+  const pathToResource = await findFileById(catalogDir, id, version);
+  if (!pathToResource) throw new Error("Cannot find resource");
+  const examplesDir = (0, import_path.join)((0, import_path.dirname)(pathToResource), "examples");
+  const examplePath = resolveExamplePath(examplesDir, fileName);
+  if (!import_node_fs2.default.existsSync(examplePath)) {
+    throw new Error(`Example file ${fileName} does not exist in resource ${id}${version ? ` v(${version})` : ""}`);
+  }
+  import_node_fs2.default.unlinkSync(examplePath);
+};
 var isLatestVersion = async (catalogDir, id, version) => {
   const resource = await getResource(catalogDir, id, version);
   if (!resource) return false;
@@ -1136,6 +1185,9 @@ var eventHasVersion = (directory) => async (id, version) => {
   const file = await findFileById(directory, id, version);
   return !!file;
 };
+var addExampleToEvent = (directory) => async (id, example, version) => addExampleToResource(directory, id, example, version);
+var getExamplesFromEvent = (directory) => async (id, version) => getExamplesFromResource(directory, id, version);
+var removeExampleFromEvent = (directory) => async (id, fileName, version) => removeExampleFromResource(directory, id, fileName, version);
 
 // src/commands.ts
 var import_promises3 = __toESM(require("fs/promises"));
@@ -1171,6 +1223,9 @@ var commandHasVersion = (directory) => async (id, version) => {
   const file = await findFileById(directory, id, version);
   return !!file;
 };
+var addExampleToCommand = (directory) => async (id, example, version) => addExampleToResource(directory, id, example, version);
+var getExamplesFromCommand = (directory) => async (id, version) => getExamplesFromResource(directory, id, version);
+var removeExampleFromCommand = (directory) => async (id, fileName, version) => removeExampleFromResource(directory, id, fileName, version);
 
 // src/queries.ts
 var import_promises4 = __toESM(require("fs/promises"));
@@ -1208,6 +1263,9 @@ var queryHasVersion = (directory) => async (id, version) => {
   const file = await findFileById(directory, id, version);
   return !!file;
 };
+var addExampleToQuery = (directory) => async (id, example, version) => addExampleToResource(directory, id, example, version);
+var getExamplesFromQuery = (directory) => async (id, version) => getExamplesFromResource(directory, id, version);
+var removeExampleFromQuery = (directory) => async (id, fileName, version) => removeExampleFromResource(directory, id, fileName, version);
 
 // src/services.ts
 var import_promises5 = __toESM(require("fs/promises"));
@@ -1983,6 +2041,7 @@ var dumpCatalog = (directory) => async (options) => {
 // src/snapshots.ts
 var import_node_fs8 = __toESM(require("fs"));
 var import_node_path16 = __toESM(require("path"));
+var import_node_crypto = require("crypto");
 var import_node_child_process = require("child_process");
 var import_semver6 = require("semver");
 
@@ -2173,6 +2232,8 @@ var pickCoreFields = (resource) => {
   if (resource.receives) picked.receives = resource.receives;
   if (resource.deprecated) picked.deprecated = resource.deprecated;
   if (resource.owners) picked.owners = resource.owners;
+  if (resource.schemaPath) picked.schemaPath = resource.schemaPath;
+  if (resource.schemaHash) picked.schemaHash = resource.schemaHash;
   return picked;
 };
 var deduplicateByLatestVersion = (resources) => {
@@ -2200,6 +2261,16 @@ var detectGitInfo = (catalogDir) => {
     return void 0;
   }
 };
+var enrichWithSchemaHashes = async (getSchemaForMessage2, resources) => {
+  await Promise.all(
+    resources.map(async (resource) => {
+      if (!resource.schemaPath) return;
+      const schema = await getSchemaForMessage2(resource.id, resource.version);
+      if (!schema) return;
+      resource.schemaHash = (0, import_node_crypto.createHash)("sha256").update(schema.schema).digest("hex");
+    })
+  );
+};
 var createSnapshot = (directory) => {
   return async (options) => {
     const { label, outputDir, git } = options || {};
@@ -2212,6 +2283,11 @@ var createSnapshot = (directory) => {
       sdk.getQueries(),
       sdk.getChannels()
     ]);
+    await Promise.all([
+      enrichWithSchemaHashes(sdk.getSchemaForMessage, events || []),
+      enrichWithSchemaHashes(sdk.getSchemaForMessage, commands || []),
+      enrichWithSchemaHashes(sdk.getSchemaForMessage, queries || [])
+    ]);
     const snapshotDomains = stripToCore(domains);
     const snapshotServices = stripToCore(services);
     const snapshotEvents = stripToCore(events);
@@ -2574,6 +2650,9 @@ var src_default = (path8) => {
      * @returns
      */
     eventHasVersion: eventHasVersion((0, import_node_path22.join)(path8)),
+    addExampleToEvent: addExampleToEvent((0, import_node_path22.join)(path8)),
+    getExamplesFromEvent: getExamplesFromEvent((0, import_node_path22.join)(path8)),
+    removeExampleFromEvent: removeExampleFromEvent((0, import_node_path22.join)(path8)),
     /**
      * ================================
      *            Commands
@@ -2651,6 +2730,9 @@ var src_default = (path8) => {
      * @returns
      */
     commandHasVersion: commandHasVersion((0, import_node_path22.join)(path8)),
+    addExampleToCommand: addExampleToCommand((0, import_node_path22.join)(path8)),
+    getExamplesFromCommand: getExamplesFromCommand((0, import_node_path22.join)(path8)),
+    removeExampleFromCommand: removeExampleFromCommand((0, import_node_path22.join)(path8)),
     /**
      * ================================
      *            Queries
@@ -2728,6 +2810,9 @@ var src_default = (path8) => {
      * @returns
      */
     queryHasVersion: queryHasVersion((0, import_node_path22.join)(path8)),
+    addExampleToQuery: addExampleToQuery((0, import_node_path22.join)(path8)),
+    getExamplesFromQuery: getExamplesFromQuery((0, import_node_path22.join)(path8)),
+    removeExampleFromQuery: removeExampleFromQuery((0, import_node_path22.join)(path8)),
     /**
      * ================================
      *            Channels