@eventcatalog/core 3.43.1 → 3.44.0

package/dist/analytics/analytics.cjs

@@ -36,7 +36,7 @@ module.exports = __toCommonJS(analytics_exports);
 var import_os = __toESM(require("os"), 1);
 
 // package.json
-var version = "3.43.1";
+var version = "3.44.0";
 
 // src/constants.ts
 var VERSION = version;

package/dist/analytics/analytics.js

@@ -1,7 +1,7 @@
 import {
   raiseEvent
-} from "../chunk-C6S5P57F.js";
-import "../chunk-KV5FCOV4.js";
+} from "../chunk-H7IGB2WO.js";
+import "../chunk-W7UIDHNR.js";
 export {
   raiseEvent
 };

package/dist/analytics/log-build.cjs

@@ -48,6 +48,36 @@ async function cleanup(projectDirectory) {
     await (0, import_promises.rm)(filePath);
   }
 }
+var findNodeModulesDirectory = (directory) => {
+  let currentDirectory = directory;
+  while (true) {
+    const nodeModulesDirectory = import_node_path.default.join(currentDirectory, "node_modules");
+    if ((0, import_node_fs.existsSync)(nodeModulesDirectory)) {
+      return nodeModulesDirectory;
+    }
+    const parentDirectory = import_node_path.default.dirname(currentDirectory);
+    if (parentDirectory === currentDirectory) {
+      return void 0;
+    }
+    currentDirectory = parentDirectory;
+  }
+};
+var linkNodeModulesIntoTempDirectory = async ({ projectDirectory, tempDir }) => {
+  const nodeModulesDirectory = findNodeModulesDirectory(projectDirectory);
+  if (!nodeModulesDirectory) {
+    return;
+  }
+  await (0, import_promises.symlink)(nodeModulesDirectory, import_node_path.default.join(tempDir, "node_modules"), "dir");
+};
+var createTemporaryConfigDirectory = async (projectDirectory) => {
+  const nodeModulesDirectory = findNodeModulesDirectory(projectDirectory);
+  if (nodeModulesDirectory) {
+    return (0, import_promises.mkdtemp)(import_node_path.default.join(nodeModulesDirectory, ".eventcatalog-config-"));
+  }
+  const tempDir = await (0, import_promises.mkdtemp)(import_node_path.default.join((0, import_node_os.tmpdir)(), "eventcatalog-config-"));
+  await linkNodeModulesIntoTempDirectory({ projectDirectory, tempDir });
+  return tempDir;
+};
 var getEventCatalogConfigFile = async (projectDirectory) => {
   let tempDir;
   try {
@@ -55,7 +85,7 @@ var getEventCatalogConfigFile = async (projectDirectory) => {
     const filePath = import_node_path.default.join(projectDirectory, "package.json");
     const packageJson = JSON.parse(await (0, import_promises.readFile)(filePath, "utf-8"));
     if (packageJson?.type !== "module") {
-      tempDir = await (0, import_promises.mkdtemp)(import_node_path.default.join((0, import_node_os.tmpdir)(), "eventcatalog-config-"));
+      tempDir = await createTemporaryConfigDirectory(projectDirectory);
       configFilePath = import_node_path.default.join(tempDir, "eventcatalog.config.mjs");
       await (0, import_promises.copyFile)(import_node_path.default.join(projectDirectory, "eventcatalog.config.js"), configFilePath);
     }
@@ -110,7 +140,7 @@ var verifyRequiredFieldsAreInCatalogConfigFile = async (projectDirectory) => {
 var import_os = __toESM(require("os"), 1);
 
 // package.json
-var version = "3.43.1";
+var version = "3.44.0";
 
 // src/constants.ts
 var VERSION = version;
@@ -195,6 +225,23 @@ var getFeatures = async (configFile) => {
     output: configFile.output || "static"
   };
 };
+var getDirectoryProvider = (source) => {
+  if (!source?.name || typeof source.name !== "string") return "unknown";
+  return source.name.split(":")[0] || "unknown";
+};
+var serializeDirectorySources = (configFile) => {
+  const sources = configFile.directory?.sources;
+  if (!Array.isArray(sources) || sources.length === 0) return "none";
+  const providerCounts = sources.reduce((counts, source) => {
+    const provider = getDirectoryProvider(source);
+    counts[provider] = (counts[provider] || 0) + 1;
+    return counts;
+  }, {});
+  const providers = Object.keys(providerCounts).sort().map((provider) => `${provider}:${providerCounts[provider]}`).join(",");
+  const hasUsers = sources.some((source) => typeof source?.loadUsers === "function");
+  const hasTeams = sources.some((source) => typeof source?.loadTeams === "function");
+  return `sources:${sources.length},providers:${providers},users:${hasUsers},teams:${hasTeams}`;
+};
 var CLOUD_ANALYTICS_ENDPOINT = "https://api.ecingest.dev/v1/analytics/ingest";
 var toCloudResourceCounts = (counts) => ({
   adrs: counts.adrs || 0,
@@ -257,6 +304,7 @@ var main = async (projectDir, { isEventCatalogStarterEnabled, isEventCatalogScal
       cId,
       generators: generatorNames.toString(),
       features: Object.keys(features).map((feature) => `${feature}:${features[feature]}`).join(","),
+      directorySources: serializeDirectorySources(configFile),
       resources: serializeCounts(resourceCounts)
     });
   } catch (error) {

package/dist/analytics/log-build.js

@@ -1,10 +1,10 @@
 import {
   log_build_default
-} from "../chunk-OOX6HAE4.js";
-import "../chunk-C6S5P57F.js";
+} from "../chunk-SWSSBJ6H.js";
+import "../chunk-H7IGB2WO.js";
 import "../chunk-DAOXTQVS.js";
-import "../chunk-KV5FCOV4.js";
-import "../chunk-5T63CXKU.js";
+import "../chunk-W7UIDHNR.js";
+import "../chunk-6QENHZZP.js";
 export {
   log_build_default as default
 };

package/dist/catalog-to-astro-content-directory.cjs

@@ -59,6 +59,36 @@ async function cleanup(projectDirectory) {
     await (0, import_promises.rm)(filePath);
   }
 }
+var findNodeModulesDirectory = (directory) => {
+  let currentDirectory = directory;
+  while (true) {
+    const nodeModulesDirectory = import_node_path.default.join(currentDirectory, "node_modules");
+    if ((0, import_node_fs.existsSync)(nodeModulesDirectory)) {
+      return nodeModulesDirectory;
+    }
+    const parentDirectory = import_node_path.default.dirname(currentDirectory);
+    if (parentDirectory === currentDirectory) {
+      return void 0;
+    }
+    currentDirectory = parentDirectory;
+  }
+};
+var linkNodeModulesIntoTempDirectory = async ({ projectDirectory, tempDir }) => {
+  const nodeModulesDirectory = findNodeModulesDirectory(projectDirectory);
+  if (!nodeModulesDirectory) {
+    return;
+  }
+  await (0, import_promises.symlink)(nodeModulesDirectory, import_node_path.default.join(tempDir, "node_modules"), "dir");
+};
+var createTemporaryConfigDirectory = async (projectDirectory) => {
+  const nodeModulesDirectory = findNodeModulesDirectory(projectDirectory);
+  if (nodeModulesDirectory) {
+    return (0, import_promises.mkdtemp)(import_node_path.default.join(nodeModulesDirectory, ".eventcatalog-config-"));
+  }
+  const tempDir = await (0, import_promises.mkdtemp)(import_node_path.default.join((0, import_node_os.tmpdir)(), "eventcatalog-config-"));
+  await linkNodeModulesIntoTempDirectory({ projectDirectory, tempDir });
+  return tempDir;
+};
 var getEventCatalogConfigFile = async (projectDirectory) => {
   let tempDir;
   try {
@@ -66,7 +96,7 @@ var getEventCatalogConfigFile = async (projectDirectory) => {
     const filePath = import_node_path.default.join(projectDirectory, "package.json");
     const packageJson = JSON.parse(await (0, import_promises.readFile)(filePath, "utf-8"));
     if (packageJson?.type !== "module") {
-      tempDir = await (0, import_promises.mkdtemp)(import_node_path.default.join((0, import_node_os.tmpdir)(), "eventcatalog-config-"));
+      tempDir = await createTemporaryConfigDirectory(projectDirectory);
       configFilePath = import_node_path.default.join(tempDir, "eventcatalog.config.mjs");
       await (0, import_promises.copyFile)(import_node_path.default.join(projectDirectory, "eventcatalog.config.js"), configFilePath);
     }

package/dist/catalog-to-astro-content-directory.js

@@ -1,8 +1,8 @@
 import {
   catalogToAstro
-} from "./chunk-O6KT4DPL.js";
+} from "./chunk-4SMA4HQ3.js";
 import "./chunk-IR4IAKWS.js";
-import "./chunk-5T63CXKU.js";
+import "./chunk-6QENHZZP.js";
 export {
   catalogToAstro
 };

package/dist/{chunk-O6KT4DPL.js → chunk-4SMA4HQ3.js}

@@ -3,7 +3,7 @@ import {
 } from "./chunk-IR4IAKWS.js";
 import {
   verifyRequiredFieldsAreInCatalogConfigFile
-} from "./chunk-5T63CXKU.js";
+} from "./chunk-6QENHZZP.js";
 
 // src/catalog-to-astro-content-directory.js
 import { glob } from "glob";

package/dist/{chunk-5T63CXKU.js → chunk-6QENHZZP.js}

@@ -1,5 +1,5 @@
 // src/eventcatalog-config-file-utils.js
-import { readFile, writeFile, rm, copyFile, mkdtemp } from "fs/promises";
+import { readFile, writeFile, rm, copyFile, mkdtemp, symlink } from "fs/promises";
 import { existsSync } from "fs";
 import path from "path";
 import { v4 as uuidV4 } from "uuid";
@@ -12,6 +12,36 @@ async function cleanup(projectDirectory) {
     await rm(filePath);
   }
 }
+var findNodeModulesDirectory = (directory) => {
+  let currentDirectory = directory;
+  while (true) {
+    const nodeModulesDirectory = path.join(currentDirectory, "node_modules");
+    if (existsSync(nodeModulesDirectory)) {
+      return nodeModulesDirectory;
+    }
+    const parentDirectory = path.dirname(currentDirectory);
+    if (parentDirectory === currentDirectory) {
+      return void 0;
+    }
+    currentDirectory = parentDirectory;
+  }
+};
+var linkNodeModulesIntoTempDirectory = async ({ projectDirectory, tempDir }) => {
+  const nodeModulesDirectory = findNodeModulesDirectory(projectDirectory);
+  if (!nodeModulesDirectory) {
+    return;
+  }
+  await symlink(nodeModulesDirectory, path.join(tempDir, "node_modules"), "dir");
+};
+var createTemporaryConfigDirectory = async (projectDirectory) => {
+  const nodeModulesDirectory = findNodeModulesDirectory(projectDirectory);
+  if (nodeModulesDirectory) {
+    return mkdtemp(path.join(nodeModulesDirectory, ".eventcatalog-config-"));
+  }
+  const tempDir = await mkdtemp(path.join(tmpdir(), "eventcatalog-config-"));
+  await linkNodeModulesIntoTempDirectory({ projectDirectory, tempDir });
+  return tempDir;
+};
 var getEventCatalogConfigFile = async (projectDirectory) => {
   let tempDir;
   try {
@@ -19,7 +49,7 @@ var getEventCatalogConfigFile = async (projectDirectory) => {
     const filePath = path.join(projectDirectory, "package.json");
     const packageJson = JSON.parse(await readFile(filePath, "utf-8"));
     if (packageJson?.type !== "module") {
-      tempDir = await mkdtemp(path.join(tmpdir(), "eventcatalog-config-"));
+      tempDir = await createTemporaryConfigDirectory(projectDirectory);
       configFilePath = path.join(tempDir, "eventcatalog.config.mjs");
       await copyFile(path.join(projectDirectory, "eventcatalog.config.js"), configFilePath);
     }

package/dist/{chunk-2GQO7I7E.js → chunk-A7WJATRV.js}

@@ -1,10 +1,10 @@
 import {
   logger
-} from "./chunk-Z5QHV4ZY.js";
+} from "./chunk-L2JZBH6K.js";
 import {
   cleanup,
   getEventCatalogConfigFile
-} from "./chunk-5T63CXKU.js";
+} from "./chunk-6QENHZZP.js";
 
 // src/generate.js
 import path from "path";

package/dist/{chunk-ULZYHF3V.js → chunk-B7HCX5HM.js}

@@ -1,6 +1,6 @@
 import {
   getEventCatalogConfigFile
-} from "./chunk-5T63CXKU.js";
+} from "./chunk-6QENHZZP.js";
 
 // src/features.ts
 import { join } from "path";

package/dist/{chunk-C6S5P57F.js → chunk-H7IGB2WO.js}

@@ -1,6 +1,6 @@
 import {
   VERSION
-} from "./chunk-KV5FCOV4.js";
+} from "./chunk-W7UIDHNR.js";
 
 // src/analytics/analytics.js
 import os from "os";

package/dist/{chunk-Z5QHV4ZY.js → chunk-L2JZBH6K.js}

@@ -1,6 +1,6 @@
 import {
   VERSION
-} from "./chunk-KV5FCOV4.js";
+} from "./chunk-W7UIDHNR.js";
 
 // src/utils/cli-logger.ts
 import pc from "picocolors";

package/dist/{chunk-WAJIJEI3.js → chunk-LHR4G2UO.js}

@@ -1,6 +1,6 @@
 import {
   getEventCatalogConfigFile
-} from "./chunk-5T63CXKU.js";
+} from "./chunk-6QENHZZP.js";
 
 // src/resolve-catalog-dependencies.js
 import path from "path";

package/dist/{chunk-OOX6HAE4.js → chunk-SWSSBJ6H.js}

@@ -1,6 +1,6 @@
 import {
   raiseEvent
-} from "./chunk-C6S5P57F.js";
+} from "./chunk-H7IGB2WO.js";
 import {
   countResources,
   serializeCounts
@@ -8,7 +8,7 @@ import {
 import {
   getEventCatalogConfigFile,
   verifyRequiredFieldsAreInCatalogConfigFile
-} from "./chunk-5T63CXKU.js";
+} from "./chunk-6QENHZZP.js";
 
 // src/analytics/log-build.js
 var getFeatures = async (configFile) => {
@@ -19,6 +19,23 @@ var getFeatures = async (configFile) => {
     output: configFile.output || "static"
   };
 };
+var getDirectoryProvider = (source) => {
+  if (!source?.name || typeof source.name !== "string") return "unknown";
+  return source.name.split(":")[0] || "unknown";
+};
+var serializeDirectorySources = (configFile) => {
+  const sources = configFile.directory?.sources;
+  if (!Array.isArray(sources) || sources.length === 0) return "none";
+  const providerCounts = sources.reduce((counts, source) => {
+    const provider = getDirectoryProvider(source);
+    counts[provider] = (counts[provider] || 0) + 1;
+    return counts;
+  }, {});
+  const providers = Object.keys(providerCounts).sort().map((provider) => `${provider}:${providerCounts[provider]}`).join(",");
+  const hasUsers = sources.some((source) => typeof source?.loadUsers === "function");
+  const hasTeams = sources.some((source) => typeof source?.loadTeams === "function");
+  return `sources:${sources.length},providers:${providers},users:${hasUsers},teams:${hasTeams}`;
+};
 var CLOUD_ANALYTICS_ENDPOINT = "https://api.ecingest.dev/v1/analytics/ingest";
 var toCloudResourceCounts = (counts) => ({
   adrs: counts.adrs || 0,
@@ -81,6 +98,7 @@ var main = async (projectDir, { isEventCatalogStarterEnabled, isEventCatalogScal
       cId,
       generators: generatorNames.toString(),
       features: Object.keys(features).map((feature) => `${feature}:${features[feature]}`).join(","),
+      directorySources: serializeDirectorySources(configFile),
       resources: serializeCounts(resourceCounts)
     });
   } catch (error) {

package/dist/{chunk-KV5FCOV4.js → chunk-W7UIDHNR.js}

@@ -1,5 +1,5 @@
 // package.json
-var version = "3.43.1";
+var version = "3.44.0";
 
 // src/constants.ts
 var VERSION = version;

package/dist/constants.cjs

@@ -25,7 +25,7 @@ __export(constants_exports, {
 module.exports = __toCommonJS(constants_exports);
 
 // package.json
-var version = "3.43.1";
+var version = "3.44.0";
 
 // src/constants.ts
 var VERSION = version;

package/dist/constants.js

@@ -1,6 +1,6 @@
 import {
   VERSION
-} from "./chunk-KV5FCOV4.js";
+} from "./chunk-W7UIDHNR.js";
 export {
   VERSION
 };

package/dist/eventcatalog-config-file-utils.cjs

@@ -50,6 +50,36 @@ async function cleanup(projectDirectory) {
     await (0, import_promises.rm)(filePath);
   }
 }
+var findNodeModulesDirectory = (directory) => {
+  let currentDirectory = directory;
+  while (true) {
+    const nodeModulesDirectory = import_node_path.default.join(currentDirectory, "node_modules");
+    if ((0, import_node_fs.existsSync)(nodeModulesDirectory)) {
+      return nodeModulesDirectory;
+    }
+    const parentDirectory = import_node_path.default.dirname(currentDirectory);
+    if (parentDirectory === currentDirectory) {
+      return void 0;
+    }
+    currentDirectory = parentDirectory;
+  }
+};
+var linkNodeModulesIntoTempDirectory = async ({ projectDirectory, tempDir }) => {
+  const nodeModulesDirectory = findNodeModulesDirectory(projectDirectory);
+  if (!nodeModulesDirectory) {
+    return;
+  }
+  await (0, import_promises.symlink)(nodeModulesDirectory, import_node_path.default.join(tempDir, "node_modules"), "dir");
+};
+var createTemporaryConfigDirectory = async (projectDirectory) => {
+  const nodeModulesDirectory = findNodeModulesDirectory(projectDirectory);
+  if (nodeModulesDirectory) {
+    return (0, import_promises.mkdtemp)(import_node_path.default.join(nodeModulesDirectory, ".eventcatalog-config-"));
+  }
+  const tempDir = await (0, import_promises.mkdtemp)(import_node_path.default.join((0, import_node_os.tmpdir)(), "eventcatalog-config-"));
+  await linkNodeModulesIntoTempDirectory({ projectDirectory, tempDir });
+  return tempDir;
+};
 var getEventCatalogConfigFile = async (projectDirectory) => {
   let tempDir;
   try {
@@ -57,7 +87,7 @@ var getEventCatalogConfigFile = async (projectDirectory) => {
     const filePath = import_node_path.default.join(projectDirectory, "package.json");
     const packageJson = JSON.parse(await (0, import_promises.readFile)(filePath, "utf-8"));
     if (packageJson?.type !== "module") {
-      tempDir = await (0, import_promises.mkdtemp)(import_node_path.default.join((0, import_node_os.tmpdir)(), "eventcatalog-config-"));
+      tempDir = await createTemporaryConfigDirectory(projectDirectory);
       configFilePath = import_node_path.default.join(tempDir, "eventcatalog.config.mjs");
       await (0, import_promises.copyFile)(import_node_path.default.join(projectDirectory, "eventcatalog.config.js"), configFilePath);
     }

package/dist/eventcatalog-config-file-utils.js

@@ -4,7 +4,7 @@ import {
   getEventCatalogConfigFile,
   verifyRequiredFieldsAreInCatalogConfigFile,
   writeEventCatalogConfigFile
-} from "./chunk-5T63CXKU.js";
+} from "./chunk-6QENHZZP.js";
 export {
   addPropertyToFrontMatter,
   cleanup,

package/dist/eventcatalog.cjs

@@ -52,6 +52,36 @@ async function cleanup(projectDirectory) {
     await (0, import_promises.rm)(filePath);
   }
 }
+var findNodeModulesDirectory = (directory) => {
+  let currentDirectory = directory;
+  while (true) {
+    const nodeModulesDirectory = import_node_path.default.join(currentDirectory, "node_modules");
+    if ((0, import_node_fs.existsSync)(nodeModulesDirectory)) {
+      return nodeModulesDirectory;
+    }
+    const parentDirectory = import_node_path.default.dirname(currentDirectory);
+    if (parentDirectory === currentDirectory) {
+      return void 0;
+    }
+    currentDirectory = parentDirectory;
+  }
+};
+var linkNodeModulesIntoTempDirectory = async ({ projectDirectory, tempDir }) => {
+  const nodeModulesDirectory = findNodeModulesDirectory(projectDirectory);
+  if (!nodeModulesDirectory) {
+    return;
+  }
+  await (0, import_promises.symlink)(nodeModulesDirectory, import_node_path.default.join(tempDir, "node_modules"), "dir");
+};
+var createTemporaryConfigDirectory = async (projectDirectory) => {
+  const nodeModulesDirectory = findNodeModulesDirectory(projectDirectory);
+  if (nodeModulesDirectory) {
+    return (0, import_promises.mkdtemp)(import_node_path.default.join(nodeModulesDirectory, ".eventcatalog-config-"));
+  }
+  const tempDir = await (0, import_promises.mkdtemp)(import_node_path.default.join((0, import_node_os.tmpdir)(), "eventcatalog-config-"));
+  await linkNodeModulesIntoTempDirectory({ projectDirectory, tempDir });
+  return tempDir;
+};
 var getEventCatalogConfigFile = async (projectDirectory) => {
   let tempDir;
   try {
@@ -59,7 +89,7 @@ var getEventCatalogConfigFile = async (projectDirectory) => {
     const filePath = import_node_path.default.join(projectDirectory, "package.json");
     const packageJson = JSON.parse(await (0, import_promises.readFile)(filePath, "utf-8"));
     if (packageJson?.type !== "module") {
-      tempDir = await (0, import_promises.mkdtemp)(import_node_path.default.join((0, import_node_os.tmpdir)(), "eventcatalog-config-"));
+      tempDir = await createTemporaryConfigDirectory(projectDirectory);
       configFilePath = import_node_path.default.join(tempDir, "eventcatalog.config.mjs");
       await (0, import_promises.copyFile)(import_node_path.default.join(projectDirectory, "eventcatalog.config.js"), configFilePath);
     }
@@ -114,7 +144,7 @@ var verifyRequiredFieldsAreInCatalogConfigFile = async (projectDirectory) => {
 var import_picocolors = __toESM(require("picocolors"), 1);
 
 // package.json
-var version = "3.43.1";
+var version = "3.44.0";
 
 // src/constants.ts
 var VERSION = version;
@@ -290,6 +320,23 @@ var getFeatures = async (configFile) => {
     output: configFile.output || "static"
   };
 };
+var getDirectoryProvider = (source) => {
+  if (!source?.name || typeof source.name !== "string") return "unknown";
+  return source.name.split(":")[0] || "unknown";
+};
+var serializeDirectorySources = (configFile) => {
+  const sources = configFile.directory?.sources;
+  if (!Array.isArray(sources) || sources.length === 0) return "none";
+  const providerCounts = sources.reduce((counts, source) => {
+    const provider = getDirectoryProvider(source);
+    counts[provider] = (counts[provider] || 0) + 1;
+    return counts;
+  }, {});
+  const providers = Object.keys(providerCounts).sort().map((provider) => `${provider}:${providerCounts[provider]}`).join(",");
+  const hasUsers = sources.some((source) => typeof source?.loadUsers === "function");
+  const hasTeams = sources.some((source) => typeof source?.loadTeams === "function");
+  return `sources:${sources.length},providers:${providers},users:${hasUsers},teams:${hasTeams}`;
+};
 var CLOUD_ANALYTICS_ENDPOINT = "https://api.ecingest.dev/v1/analytics/ingest";
 var toCloudResourceCounts = (counts) => ({
   adrs: counts.adrs || 0,
@@ -352,6 +399,7 @@ var main = async (projectDir, { isEventCatalogStarterEnabled: isEventCatalogStar
       cId,
       generators: generatorNames.toString(),
       features: Object.keys(features).map((feature) => `${feature}:${features[feature]}`).join(","),
+      directorySources: serializeDirectorySources(configFile),
       resources: serializeCounts(resourceCounts)
     });
   } catch (error) {

package/dist/eventcatalog.config.d.cts

@@ -47,6 +47,30 @@ type PagesConfiguration = {
 };
 type NavigationPage = string | PagesConfiguration;
 type GeneratorConfig = string | Record<string, unknown> | [string, Record<string, unknown>];
+type DirectoryEntry = {
+    id: string;
+    markdown?: string;
+    [key: string]: unknown;
+};
+type DirectorySource = {
+    type: 'directory';
+    name: string;
+    loadUsers?: () => Promise<DirectoryEntry[]>;
+    loadTeams?: () => Promise<DirectoryEntry[]>;
+};
+type DirectoryConfig = {
+    /**
+     * External sources that sync users and teams into EventCatalog.
+     * Requires EventCatalog Scale.
+     */
+    sources?: DirectorySource[];
+    /**
+     * Controls what happens when a local Markdown user/team and an external source
+     * return the same id.
+     * @default 'local-wins'
+     */
+    conflictStrategy?: 'local-wins' | 'source-wins' | 'error';
+};
 type AuthConfig = {
     enabled: boolean;
 };
@@ -196,6 +220,7 @@ interface Config {
         services?: ResourceDependency[];
         domains?: ResourceDependency[];
     };
+    directory?: DirectoryConfig;
     mermaid?: {
         maxTextSize?: number;
         iconPacks?: string[];

package/dist/eventcatalog.config.d.ts

@@ -47,6 +47,30 @@ type PagesConfiguration = {
 };
 type NavigationPage = string | PagesConfiguration;
 type GeneratorConfig = string | Record<string, unknown> | [string, Record<string, unknown>];
+type DirectoryEntry = {
+    id: string;
+    markdown?: string;
+    [key: string]: unknown;
+};
+type DirectorySource = {
+    type: 'directory';
+    name: string;
+    loadUsers?: () => Promise<DirectoryEntry[]>;
+    loadTeams?: () => Promise<DirectoryEntry[]>;
+};
+type DirectoryConfig = {
+    /**
+     * External sources that sync users and teams into EventCatalog.
+     * Requires EventCatalog Scale.
+     */
+    sources?: DirectorySource[];
+    /**
+     * Controls what happens when a local Markdown user/team and an external source
+     * return the same id.
+     * @default 'local-wins'
+     */
+    conflictStrategy?: 'local-wins' | 'source-wins' | 'error';
+};
 type AuthConfig = {
     enabled: boolean;
 };
@@ -196,6 +220,7 @@ interface Config {
         services?: ResourceDependency[];
         domains?: ResourceDependency[];
     };
+    directory?: DirectoryConfig;
     mermaid?: {
         maxTextSize?: number;
         iconPacks?: string[];

package/dist/eventcatalog.js

@@ -4,7 +4,7 @@ import {
 import "./chunk-CA4U2JP7.js";
 import {
   resolve_catalog_dependencies_default
-} from "./chunk-WAJIJEI3.js";
+} from "./chunk-LHR4G2UO.js";
 import {
   buildSearchIndex
 } from "./chunk-ZONBICNH.js";
@@ -13,32 +13,32 @@ import {
 } from "./chunk-3H2RT3CM.js";
 import {
   log_build_default
-} from "./chunk-OOX6HAE4.js";
-import "./chunk-C6S5P57F.js";
+} from "./chunk-SWSSBJ6H.js";
+import "./chunk-H7IGB2WO.js";
 import "./chunk-DAOXTQVS.js";
 import {
   catalogToAstro
-} from "./chunk-O6KT4DPL.js";
+} from "./chunk-4SMA4HQ3.js";
 import "./chunk-IR4IAKWS.js";
 import {
   getProjectOutDir,
   isAuthEnabled,
   isIndexedSearchEnabled,
   isOutputServer
-} from "./chunk-ULZYHF3V.js";
+} from "./chunk-B7HCX5HM.js";
 import {
   generate
-} from "./chunk-2GQO7I7E.js";
+} from "./chunk-A7WJATRV.js";
 import {
   logger
-} from "./chunk-Z5QHV4ZY.js";
+} from "./chunk-L2JZBH6K.js";
 import {
   VERSION
-} from "./chunk-KV5FCOV4.js";
+} from "./chunk-W7UIDHNR.js";
 import {
   getEventCatalogConfigFile,
   verifyRequiredFieldsAreInCatalogConfigFile
-} from "./chunk-5T63CXKU.js";
+} from "./chunk-6QENHZZP.js";
 
 // src/eventcatalog.ts
 import { Command } from "commander";