@eventcatalog/core 4.7.2 → 4.7.4

package/dist/eventcatalog.cjs

@@ -29,10 +29,10 @@ var importMetaUrl = /* @__PURE__ */ getImportMetaUrl();
 // src/eventcatalog.ts
 var import_commander = require("commander");
 var import_node_child_process2 = require("child_process");
-var import_node_path14 = require("path");
+var import_node_path16 = require("path");
 var import_node_http = __toESM(require("http"), 1);
 var import_fs3 = __toESM(require("fs"), 1);
-var import_node_path15 = __toESM(require("path"), 1);
+var import_node_path17 = __toESM(require("path"), 1);
 var import_node_url = require("url");
 
 // src/generate.js
@@ -144,7 +144,7 @@ var verifyRequiredFieldsAreInCatalogConfigFile = async (projectDirectory) => {
 var import_picocolors = __toESM(require("picocolors"), 1);
 
 // package.json
-var version = "4.7.2";
+var version = "4.7.4";
 
 // src/constants.ts
 var VERSION = version;
@@ -632,29 +632,82 @@ function retryEPERM(fn) {
 
 // src/catalog-to-astro-content-directory.js
 var import_glob2 = require("glob");
-var path4 = __toESM(require("path"), 1);
+var path5 = __toESM(require("path"), 1);
 var import_fs = __toESM(require("fs"), 1);
 var import_url2 = require("url");
 var import_node_os2 = __toESM(require("os"), 1);
+
+// src/custom-components.js
+var import_promises2 = __toESM(require("fs/promises"), 1);
+var import_node_path4 = __toESM(require("path"), 1);
+var isCustomComponentPath = (projectDirectory, filePath) => {
+  const [rootDirectory, childDirectory] = import_node_path4.default.relative(projectDirectory, filePath).split(import_node_path4.default.sep);
+  return rootDirectory === "components" || rootDirectory === "federated" && childDirectory === "components";
+};
+var readDirectory = async (directory) => {
+  try {
+    return await import_promises2.default.readdir(directory, { withFileTypes: true });
+  } catch (error) {
+    if (error.code === "ENOENT") return [];
+    throw error;
+  }
+};
+var mergeDirectory = async (sourceDirectory, destinationDirectory) => {
+  for (const entry of await readDirectory(sourceDirectory)) {
+    const sourcePath = import_node_path4.default.join(sourceDirectory, entry.name);
+    const destinationPath = import_node_path4.default.join(destinationDirectory, entry.name);
+    if (entry.isDirectory()) {
+      const destinationEntry = await import_promises2.default.stat(destinationPath).catch((error) => {
+        if (error.code === "ENOENT") return void 0;
+        throw error;
+      });
+      if (destinationEntry && !destinationEntry.isDirectory()) {
+        await import_promises2.default.rm(destinationPath, { recursive: true, force: true });
+      }
+      await import_promises2.default.mkdir(destinationPath, { recursive: true });
+      await mergeDirectory(sourcePath, destinationPath);
+      continue;
+    }
+    await import_promises2.default.rm(destinationPath, { recursive: true, force: true });
+    await import_promises2.default.copyFile(sourcePath, destinationPath);
+  }
+};
+var syncCustomComponents = async (projectDirectory, catalogDirectory) => {
+  const destinationDirectory = import_node_path4.default.join(catalogDirectory, "src", "custom-defined-components");
+  const destinationParent = import_node_path4.default.dirname(destinationDirectory);
+  await import_promises2.default.mkdir(destinationParent, { recursive: true });
+  const stagingDirectory = await import_promises2.default.mkdtemp(import_node_path4.default.join(destinationParent, ".custom-defined-components.staging-"));
+  try {
+    await mergeDirectory(import_node_path4.default.join(projectDirectory, "federated", "components"), stagingDirectory);
+    await mergeDirectory(import_node_path4.default.join(projectDirectory, "components"), stagingDirectory);
+    await import_promises2.default.rm(destinationDirectory, { recursive: true, force: true });
+    await import_promises2.default.rename(stagingDirectory, destinationDirectory);
+  } finally {
+    await import_promises2.default.rm(stagingDirectory, { recursive: true, force: true });
+  }
+};
+
+// src/catalog-to-astro-content-directory.js
 var __filename2 = (0, import_url2.fileURLToPath)(importMetaUrl);
-var rootPkg = path4.resolve(path4.dirname(__filename2), "../");
+var rootPkg = path5.resolve(path5.dirname(__filename2), "../");
 var copyFiles = async (source, target) => {
-  const files = await (0, import_glob2.glob)(path4.join(source, "**"), {
+  const files = await (0, import_glob2.glob)(path5.join(source, "**"), {
     nodir: true,
     windowsPathsNoEscape: import_node_os2.default.platform() == "win32",
     ignore: ["node_modules/**", "**/dist/**", "**/teams", "**/users", "**/*.mdx", "**/*.md", "**/package.json", "**/Dockerfile"]
   });
-  const snippets = await (0, import_glob2.glob)(path4.join(source, "snippets/**/*.mdx"), {
+  const snippets = await (0, import_glob2.glob)(path5.join(source, "snippets/**/*.mdx"), {
     nodir: true,
     windowsPathsNoEscape: import_node_os2.default.platform() == "win32"
   });
   if (snippets.length > 0) {
     files.push(...snippets);
   }
-  if (import_fs.default.existsSync(path4.join(source, ".env"))) {
-    files.push(path4.join(source, ".env"));
+  if (import_fs.default.existsSync(path5.join(source, ".env"))) {
+    files.push(path5.join(source, ".env"));
   }
   for (const file of files) {
+    if (isCustomComponentPath(source, file)) continue;
     mapCatalogToAstro({
       filePath: file,
       astroDir: target,
@@ -666,9 +719,9 @@ var copyFiles = async (source, target) => {
   }
 };
 var clearCustomPages = async (target) => {
-  const customPagesDir = path4.join(target, "src", "custom-pages");
+  const customPagesDir = path5.join(target, "src", "custom-pages");
   if (import_fs.default.existsSync(customPagesDir)) import_fs.default.rmSync(customPagesDir, { recursive: true });
-  const staleCodeFiles = await (0, import_glob2.glob)(path4.join(target, "public", "generated", "pages", "**/*.{astro,ts,js,mjs}"), {
+  const staleCodeFiles = await (0, import_glob2.glob)(path5.join(target, "public", "generated", "pages", "**/*.{astro,ts,js,mjs}"), {
     nodir: true,
     windowsPathsNoEscape: import_node_os2.default.platform() == "win32"
   });
@@ -677,8 +730,8 @@ var clearCustomPages = async (target) => {
   }
 };
 var removeGeneratedLikeC4Sources = async (target) => {
-  const generatedDir = path4.join(target, "public", "generated");
-  const files = await (0, import_glob2.glob)(path4.join(generatedDir, "**/*.{c4,likec4}"), {
+  const generatedDir = path5.join(target, "public", "generated");
+  const files = await (0, import_glob2.glob)(path5.join(generatedDir, "**/*.{c4,likec4}"), {
     nodir: true,
     windowsPathsNoEscape: import_node_os2.default.platform() == "win32"
   });
@@ -687,20 +740,21 @@ var removeGeneratedLikeC4Sources = async (target) => {
   }
 };
 var catalogToAstro = async (source, astroDir) => {
-  const astroContentDir = path4.join(astroDir, "src/content/");
+  const astroContentDir = path5.join(astroDir, "src/content/");
   if (import_fs.default.existsSync(astroContentDir)) import_fs.default.rmSync(astroContentDir, { recursive: true });
   import_fs.default.mkdirSync(astroContentDir);
   await verifyRequiredFieldsAreInCatalogConfigFile(source);
-  if (!import_fs.default.existsSync(path4.join(source, "eventcatalog.styles.css"))) {
-    import_fs.default.writeFileSync(path4.join(source, "eventcatalog.styles.css"), "");
+  if (!import_fs.default.existsSync(path5.join(source, "eventcatalog.styles.css"))) {
+    import_fs.default.writeFileSync(path5.join(source, "eventcatalog.styles.css"), "");
   }
   await clearCustomPages(astroDir);
   await removeGeneratedLikeC4Sources(astroDir);
+  await syncCustomComponents(source, astroDir);
   await copyFiles(source, astroDir);
 };
 
 // src/resolve-catalog-dependencies.js
-var import_node_path4 = __toESM(require("path"), 1);
+var import_node_path5 = __toESM(require("path"), 1);
 var import_node_fs3 = __toESM(require("fs"), 1);
 var import_gray_matter2 = __toESM(require("gray-matter"), 1);
 var resolve_catalog_dependencies_default = async (catalogDir, core2) => {
@@ -709,7 +763,7 @@ var resolve_catalog_dependencies_default = async (catalogDir, core2) => {
   if (!dependencies) {
     return;
   }
-  const dependenciesDir = import_node_path4.default.join(catalogDir, "dependencies");
+  const dependenciesDir = import_node_path5.default.join(catalogDir, "dependencies");
   if (import_node_fs3.default.existsSync(dependenciesDir)) {
     import_node_fs3.default.rmSync(dependenciesDir, { recursive: true, force: true });
   }
@@ -733,8 +787,8 @@ var resolve_catalog_dependencies_default = async (catalogDir, core2) => {
         },
         frontmatter
       );
-      const resourceFile = import_node_path4.default.join(dependenciesDir, resourceType, dependency.id, `index.md`);
-      import_node_fs3.default.mkdirSync(import_node_path4.default.dirname(resourceFile), { recursive: true });
+      const resourceFile = import_node_path5.default.join(dependenciesDir, resourceType, dependency.id, `index.md`);
+      import_node_fs3.default.mkdirSync(import_node_path5.default.dirname(resourceFile), { recursive: true });
       import_node_fs3.default.writeFileSync(resourceFile, markdown);
     }
   }
@@ -745,7 +799,7 @@ var resolve_catalog_dependencies_default = async (catalogDir, core2) => {
 var import_boxen = __toESM(require("boxen"), 1);
 
 // src/features.ts
-var import_node_path5 = require("path");
+var import_node_path6 = require("path");
 var import_node_fs4 = __toESM(require("fs"), 1);
 var getProjectOutDir = async () => {
   const config = await getEventCatalogConfigFile(process.env.PROJECT_DIR || "");
@@ -761,7 +815,7 @@ var isIndexedSearchEnabled = async () => {
 };
 var isAuthEnabled = async () => {
   const directory = process.env.PROJECT_DIR || process.cwd();
-  const hasAuthConfig = import_node_fs4.default.existsSync((0, import_node_path5.join)(directory, "eventcatalog.auth.js"));
+  const hasAuthConfig = import_node_fs4.default.existsSync((0, import_node_path6.join)(directory, "eventcatalog.auth.js"));
   return hasAuthConfig;
 };
 
@@ -774,7 +828,7 @@ var import_node_fs5 = __toESM(require("fs"), 1);
 var import_glob3 = require("glob");
 var import_node_os3 = __toESM(require("os"), 1);
 var import_gray_matter3 = __toESM(require("gray-matter"), 1);
-var import_node_path6 = __toESM(require("path"), 1);
+var import_node_path7 = __toESM(require("path"), 1);
 var DISABLE_CHANNEL_MIGRATION_ENV = "EVENTCATALOG_DISABLE_CHANNEL_MIGRATION";
 var isChannelMigrationDisabled = () => {
   return ["true", "1", "yes"].includes((process.env[DISABLE_CHANNEL_MIGRATION_ENV] ?? "").toLowerCase());
@@ -783,7 +837,7 @@ var message_channels_to_service_channels_default = async (dir2) => {
   if (isChannelMigrationDisabled()) {
     return { status: "skipped", message: `Channel migration disabled by ${DISABLE_CHANNEL_MIGRATION_ENV}` };
   }
-  const PROJECT_DIR = import_node_path6.default.join(dir2 || process.env.PROJECT_DIR);
+  const PROJECT_DIR = import_node_path7.default.join(dir2 || process.env.PROJECT_DIR);
   const messages = await (0, import_glob3.glob)(
     [
       "**/events/*/index.mdx",
@@ -890,7 +944,7 @@ var runMigrations = async (dir2) => {
 };
 
 // eventcatalog/src/enterprise/fields/field-indexer.ts
-var import_node_path7 = __toESM(require("path"), 1);
+var import_node_path8 = __toESM(require("path"), 1);
 var import_node_fs7 = __toESM(require("fs"), 1);
 
 // eventcatalog/src/enterprise/fields/fields-db.ts
@@ -1256,22 +1310,22 @@ function getAvroTypeName(type) {
 function walkAvroRecord(schema, prefix, fields) {
   if (!schema.fields || !Array.isArray(schema.fields)) return;
   for (const field of schema.fields) {
-    const path15 = prefix ? `${prefix}.${field.name}` : field.name;
+    const path17 = prefix ? `${prefix}.${field.name}` : field.name;
     const isOptional = Array.isArray(field.type) && field.type.includes("null");
     const typeName = getAvroTypeName(field.type);
     fields.push({
-      path: path15,
+      path: path17,
       type: typeName,
       description: field.doc || "",
       required: !isOptional
     });
     const innerType = Array.isArray(field.type) ? field.type.find((t) => typeof t === "object" && t.type === "record") : typeof field.type === "object" && field.type.type === "record" ? field.type : null;
     if (innerType) {
-      walkAvroRecord(innerType, path15, fields);
+      walkAvroRecord(innerType, path17, fields);
     }
     const arrayType = Array.isArray(field.type) ? field.type.find((t) => typeof t === "object" && t.type === "array") : typeof field.type === "object" && field.type.type === "array" ? field.type : null;
     if (arrayType && typeof arrayType.items === "object" && arrayType.items.type === "record") {
-      walkAvroRecord(arrayType.items, `${path15}[]`, fields);
+      walkAvroRecord(arrayType.items, `${path17}[]`, fields);
     }
   }
 }
@@ -1302,32 +1356,32 @@ function walkJsonSchema(node, prefix, requiredList, rootSchema, fields) {
   }
   if (!node.properties) return;
   for (const [name, prop] of Object.entries(node.properties)) {
-    const path15 = prefix ? `${prefix}.${name}` : name;
+    const path17 = prefix ? `${prefix}.${name}` : name;
     const isRequired = requiredList.includes(name);
     if (prop.$ref) {
       const resolved = resolveLocalRef(prop.$ref, rootSchema);
       if (resolved) {
         const rawRefType = resolved.type || "object";
         const type2 = Array.isArray(rawRefType) ? [...rawRefType].sort().join(" | ") : rawRefType;
-        fields.push({ path: path15, type: type2, description: resolved.description || "", required: isRequired });
+        fields.push({ path: path17, type: type2, description: resolved.description || "", required: isRequired });
         if (resolved.properties) {
-          walkJsonSchema(resolved, path15, resolved.required || [], rootSchema, fields);
+          walkJsonSchema(resolved, path17, resolved.required || [], rootSchema, fields);
         }
       } else {
-        fields.push({ path: path15, type: "$ref", description: "", required: isRequired });
+        fields.push({ path: path17, type: "$ref", description: "", required: isRequired });
       }
       continue;
     }
     const rawType = prop.type || (prop.enum ? "enum" : prop.$ref ? "$ref" : "object");
     const typeList = Array.isArray(rawType) ? rawType : [rawType];
     const type = Array.isArray(rawType) ? [...rawType].sort().join(" | ") : rawType;
-    fields.push({ path: path15, type, description: prop.description || "", required: isRequired });
+    fields.push({ path: path17, type, description: prop.description || "", required: isRequired });
     if (typeList.includes("object") && prop.properties) {
-      walkJsonSchema(prop, path15, prop.required || [], rootSchema, fields);
+      walkJsonSchema(prop, path17, prop.required || [], rootSchema, fields);
     }
     if (typeList.includes("array") && prop.items) {
       if (prop.items.type === "object" && prop.items.properties) {
-        walkJsonSchema(prop.items, `${path15}[]`, prop.items.required || [], rootSchema, fields);
+        walkJsonSchema(prop.items, `${path17}[]`, prop.items.required || [], rootSchema, fields);
       }
     }
   }
@@ -1345,7 +1399,7 @@ function resolveLocalRef(ref, rootSchema) {
 
 // eventcatalog/src/enterprise/fields/field-indexer.ts
 function detectFormat(fileName) {
-  const ext = import_node_path7.default.extname(fileName).toLowerCase();
+  const ext = import_node_path8.default.extname(fileName).toLowerCase();
   if (ext === ".proto") return "proto";
   if (ext === ".avro" || ext === ".avsc") return "avro";
   return "json-schema";
@@ -1353,8 +1407,8 @@ function detectFormat(fileName) {
 async function buildFieldsIndex(catalogDir, outputDir) {
   const sdkModule = await import("@eventcatalog/sdk");
   const sdk = sdkModule.default(catalogDir);
-  const dbDir = import_node_path7.default.join(outputDir || catalogDir, ".eventcatalog");
-  const dbPath = import_node_path7.default.join(dbDir, "fields.db");
+  const dbDir = import_node_path8.default.join(outputDir || catalogDir, ".eventcatalog");
+  const dbPath = import_node_path8.default.join(dbDir, "fields.db");
   if (!import_node_fs7.default.existsSync(dbDir)) {
     import_node_fs7.default.mkdirSync(dbDir, { recursive: true });
   }
@@ -1439,8 +1493,8 @@ async function buildFieldsIndex(catalogDir, outputDir) {
 }
 
 // src/search-indexer.ts
-var import_promises2 = __toESM(require("fs/promises"), 1);
-var import_node_path8 = __toESM(require("path"), 1);
+var import_promises3 = __toESM(require("fs/promises"), 1);
+var import_node_path9 = __toESM(require("path"), 1);
 var import_glob4 = require("glob");
 var import_gray_matter4 = __toESM(require("gray-matter"), 1);
 var RESOURCE_COLLECTIONS = {
@@ -1499,9 +1553,9 @@ var markdownToSearchText = (content) => {
 };
 var inferDocIdFromFile = (relativePath, frontmatterId) => {
   if (frontmatterId) return frontmatterId;
-  const fileName = import_node_path8.default.posix.basename(removeExtension(relativePath));
+  const fileName = import_node_path9.default.posix.basename(removeExtension(relativePath));
   if (fileName.toLowerCase() === "index") {
-    return import_node_path8.default.posix.basename(import_node_path8.default.posix.dirname(relativePath));
+    return import_node_path9.default.posix.basename(import_node_path9.default.posix.dirname(relativePath));
   }
   return stripNumericPrefix(fileName);
 };
@@ -1519,10 +1573,10 @@ var findResourceSegment = (segments) => {
   return match;
 };
 var readResourceFrontmatter = async (projectDir, resourcePath) => {
-  const candidates = [import_node_path8.default.join(projectDir, resourcePath, "index.mdx"), import_node_path8.default.join(projectDir, resourcePath, "index.md")];
+  const candidates = [import_node_path9.default.join(projectDir, resourcePath, "index.mdx"), import_node_path9.default.join(projectDir, resourcePath, "index.md")];
   for (const candidate of candidates) {
     try {
-      const file = await import_promises2.default.readFile(candidate, "utf8");
+      const file = await import_promises3.default.readFile(candidate, "utf8");
       return (0, import_gray_matter4.default)(file).data;
     } catch {
     }
@@ -1544,7 +1598,7 @@ var deriveRecordFromPath = async ({
   }
   if (segments[0] === "docs") {
     const customPath = normalizeUrlPath(removeExtension(segments.slice(1).join("/")));
-    const title = data.title || data.label || import_node_path8.default.posix.basename(customPath) || "Custom docs";
+    const title = data.title || data.label || import_node_path9.default.posix.basename(customPath) || "Custom docs";
     return {
       url: buildUrl(`/docs/custom/${customPath}`, config),
       title,
@@ -1660,9 +1714,9 @@ var collectSearchRecords = async ({
   });
   const records = await Promise.all(
     files.map(async (file) => {
-      const raw = await import_promises2.default.readFile(file, "utf8");
+      const raw = await import_promises3.default.readFile(file, "utf8");
       const parsed = (0, import_gray_matter4.default)(raw);
-      const relativePath = normalizePath(import_node_path8.default.relative(projectDir, file));
+      const relativePath = normalizePath(import_node_path9.default.relative(projectDir, file));
       const baseRecord = await deriveRecordFromPath({
         projectDir,
         relativePath,
@@ -1709,7 +1763,7 @@ var getSearchOutputPath = ({
   if (searchOutputPath) {
     return searchOutputPath;
   }
-  return import_node_path8.default.join(outDir, isServer ? "client" : "", "pagefind");
+  return import_node_path9.default.join(outDir, isServer ? "client" : "", "pagefind");
 };
 var buildSearchIndex = async ({ projectDir, outDir, config, isServer, searchOutputPath }) => {
   const records = await collectSearchRecords({ projectDir, config });
@@ -1745,7 +1799,7 @@ var buildSearchIndex = async ({ projectDir, outDir, config, isServer, searchOutp
     }
   }
   const outputPath = getSearchOutputPath({ outDir, isServer, searchOutputPath });
-  await import_promises2.default.rm(outputPath, { recursive: true, force: true });
+  await import_promises3.default.rm(outputPath, { recursive: true, force: true });
   const writeResult = await index.writeFiles({ outputPath });
   if (writeResult.errors?.length) {
     errors.push(...writeResult.errors.map((error) => error.message || String(error)));
@@ -1764,7 +1818,7 @@ ${errors.join("\n")}`);
 
 // src/core-node-modules.ts
 var import_fs2 = __toESM(require("fs"), 1);
-var import_node_path9 = __toESM(require("path"), 1);
+var import_node_path10 = __toESM(require("path"), 1);
 var isDirectory = (directory) => {
   try {
     return import_fs2.default.statSync(directory).isDirectory();
@@ -1774,7 +1828,7 @@ var isDirectory = (directory) => {
 };
 var hasAstroDependency = (nodeModulesDirectory) => {
   const astroBin = process.platform === "win32" ? "astro.cmd" : "astro";
-  return import_fs2.default.existsSync(import_node_path9.default.join(nodeModulesDirectory, "astro", "package.json")) || import_fs2.default.existsSync(import_node_path9.default.join(nodeModulesDirectory, ".bin", astroBin));
+  return import_fs2.default.existsSync(import_node_path10.default.join(nodeModulesDirectory, "astro", "package.json")) || import_fs2.default.existsSync(import_node_path10.default.join(nodeModulesDirectory, ".bin", astroBin));
 };
 var isSymbolicLink = (targetPath) => {
   try {
@@ -1794,20 +1848,20 @@ var resolveInstalledCoreNodeModules = (currentDir2) => {
   const candidates = [];
   const seen = /* @__PURE__ */ new Set();
   const addCandidate = (candidate) => {
-    const resolvedCandidate = import_node_path9.default.resolve(candidate);
+    const resolvedCandidate = import_node_path10.default.resolve(candidate);
     if (!seen.has(resolvedCandidate)) {
       candidates.push(resolvedCandidate);
       seen.add(resolvedCandidate);
     }
   };
-  addCandidate(import_node_path9.default.resolve(currentDir2, "..", "node_modules"));
-  let directory = import_node_path9.default.resolve(currentDir2);
+  addCandidate(import_node_path10.default.resolve(currentDir2, "..", "node_modules"));
+  let directory = import_node_path10.default.resolve(currentDir2);
   while (true) {
-    if (import_node_path9.default.basename(directory) === "node_modules") {
+    if (import_node_path10.default.basename(directory) === "node_modules") {
       addCandidate(directory);
     }
-    addCandidate(import_node_path9.default.join(directory, "node_modules"));
-    const parentDirectory = import_node_path9.default.dirname(directory);
+    addCandidate(import_node_path10.default.join(directory, "node_modules"));
+    const parentDirectory = import_node_path10.default.dirname(directory);
     if (parentDirectory === directory) {
       break;
     }
@@ -1846,28 +1900,28 @@ var createAstroDevLineFilter = () => {
 };
 
 // src/federation/federate.ts
-var import_node_crypto3 = require("crypto");
-var import_promises6 = __toESM(require("fs/promises"), 1);
-var import_node_path13 = __toESM(require("path"), 1);
-var import_sdk2 = __toESM(require("@eventcatalog/sdk"), 1);
+var import_node_crypto4 = require("crypto");
+var import_promises8 = __toESM(require("fs/promises"), 1);
+var import_node_path15 = __toESM(require("path"), 1);
+var import_sdk3 = __toESM(require("@eventcatalog/sdk"), 1);
 
 // src/federation/content-cache.ts
 var import_node_crypto = require("crypto");
-var import_promises3 = __toESM(require("fs/promises"), 1);
-var import_node_path10 = __toESM(require("path"), 1);
+var import_promises4 = __toESM(require("fs/promises"), 1);
+var import_node_path11 = __toESM(require("path"), 1);
 var getContentHash = (content) => `sha256:${(0, import_node_crypto.createHash)("sha256").update(content).digest("hex")}`;
 var isContentHash = (key) => /^sha256:[a-f0-9]{64}$/i.test(key);
 var createFederationContentCache = (projectDirectory, options = {}) => {
-  const cacheDirectory = import_node_path10.default.join(projectDirectory, ".eventcatalog-cache", "federation", "content");
-  const getCachePath = (key) => import_node_path10.default.join(cacheDirectory, encodeURIComponent(key));
+  const cacheDirectory = import_node_path11.default.join(projectDirectory, ".eventcatalog-cache", "federation", "content");
+  const getCachePath = (key) => import_node_path11.default.join(cacheDirectory, encodeURIComponent(key));
   return {
     async get(key) {
       if (options.read === false || !isContentHash(key)) return void 0;
       const cachePath = getCachePath(key);
       try {
-        const content = await import_promises3.default.readFile(cachePath);
+        const content = await import_promises4.default.readFile(cachePath);
         if (getContentHash(content) !== key) {
-          await import_promises3.default.rm(cachePath, { force: true });
+          await import_promises4.default.rm(cachePath, { force: true });
           return void 0;
         }
         options.onHit?.(key);
@@ -1879,139 +1933,19 @@ var createFederationContentCache = (projectDirectory, options = {}) => {
     },
     async set(key, content) {
       if (!isContentHash(key) || getContentHash(content) !== key) return;
-      await import_promises3.default.mkdir(cacheDirectory, { recursive: true });
+      await import_promises4.default.mkdir(cacheDirectory, { recursive: true });
       const cachePath = getCachePath(key);
       const temporaryPath = `${cachePath}.tmp-${process.pid}-${(0, import_node_crypto.randomUUID)()}`;
       try {
-        await import_promises3.default.writeFile(temporaryPath, content);
-        await import_promises3.default.rename(temporaryPath, cachePath);
+        await import_promises4.default.writeFile(temporaryPath, content);
+        await import_promises4.default.rename(temporaryPath, cachePath);
       } finally {
-        await import_promises3.default.rm(temporaryPath, { force: true });
+        await import_promises4.default.rm(temporaryPath, { force: true });
       }
     }
   };
 };
 
-// src/federation/github-source-provider.ts
-var import_node_child_process = require("child_process");
-var import_promises4 = __toESM(require("fs/promises"), 1);
-var import_node_os4 = __toESM(require("os"), 1);
-var import_node_path11 = __toESM(require("path"), 1);
-var import_node_util = require("util");
-var import_sdk = __toESM(require("@eventcatalog/sdk"), 1);
-var execFileAsync = (0, import_node_util.promisify)(import_node_child_process.execFile);
-var parseGitHubSource = (source) => {
-  const match = /^github:([^/]+)\/(.+)$/.exec(source.source);
-  if (!match) throw new Error(`Unsupported federation source "${source.source}". Expected github:owner/repository.`);
-  return { owner: match[1], repository: match[2] };
-};
-var assertSafeCatalogPath = (source) => {
-  const catalogPath = source.path ?? ".";
-  const normalized = import_node_path11.default.posix.normalize(catalogPath.replaceAll("\\", "/"));
-  if (catalogPath.includes("\\") || import_node_path11.default.posix.isAbsolute(normalized) || normalized === ".." || normalized.startsWith("../")) {
-    throw new Error(`Catalog path "${catalogPath}" escapes source "${source.id}"`);
-  }
-};
-var encodePath = (value) => value.split("/").filter(Boolean).map(encodeURIComponent).join("/");
-var rawUrl = (source, ref, filePath) => {
-  const { owner, repository } = parseGitHubSource(source);
-  return `https://raw.githubusercontent.com/${encodeURIComponent(owner)}/${encodeURIComponent(repository)}/${encodeURIComponent(
-    ref
-  )}/${encodePath(filePath)}`;
-};
-var contentsApiUrl = (source, ref, filePath) => {
-  const { owner, repository } = parseGitHubSource(source);
-  return `https://api.github.com/repos/${encodeURIComponent(owner)}/${encodeURIComponent(repository)}/contents/${encodePath(
-    filePath
-  )}?ref=${encodeURIComponent(ref)}`;
-};
-var fetchBytes = async (source, ref, filePath, fetcher, token) => {
-  const url = token ? contentsApiUrl(source, ref, filePath) : rawUrl(source, ref, filePath);
-  const response = token ? await fetcher(url, {
-    headers: {
-      Accept: "application/vnd.github.raw+json",
-      Authorization: `Bearer ${token}`,
-      "X-GitHub-Api-Version": "2026-03-10"
-    }
-  }) : await fetcher(url);
-  if (response.status === 404) return void 0;
-  if (!response.ok) throw new Error(`Failed to fetch ${url}: ${response.status} ${response.statusText}`);
-  return Buffer.from(await response.arrayBuffer());
-};
-var getGitEnvironment = (token) => {
-  if (!token) return process.env;
-  const inheritedCount = Number.parseInt(process.env.GIT_CONFIG_COUNT ?? "0", 10);
-  const configIndex = Number.isInteger(inheritedCount) && inheritedCount >= 0 ? inheritedCount : 0;
-  return {
-    ...process.env,
-    GIT_CONFIG_COUNT: String(configIndex + 1),
-    [`GIT_CONFIG_KEY_${configIndex}`]: "http.https://github.com/.extraheader",
-    [`GIT_CONFIG_VALUE_${configIndex}`]: `AUTHORIZATION: basic ${Buffer.from(`x-access-token:${token}`).toString("base64")}`
-  };
-};
-var createCheckout = (executeFile, token) => async (source, ref, callback) => {
-  const { owner, repository } = parseGitHubSource(source);
-  const catalogPath = import_node_path11.default.posix.normalize(source.path ?? ".");
-  const directory = await import_promises4.default.mkdtemp(import_node_path11.default.join(import_node_os4.default.tmpdir(), "eventcatalog-federation-"));
-  const env = getGitEnvironment(token);
-  try {
-    const git = (args) => executeFile("git", args, { cwd: directory, env, encoding: "utf8" });
-    await git(["init", "--quiet"]);
-    await git(["remote", "add", "origin", `https://github.com/${owner}/${repository}.git`]);
-    if (catalogPath !== ".") {
-      await git(["sparse-checkout", "init", "--cone"]);
-      await git(["sparse-checkout", "set", catalogPath]);
-    }
-    await git(["fetch", "--quiet", "--depth", "1", "origin", ref]);
-    await git(["checkout", "--quiet", "--detach", "FETCH_HEAD"]);
-    return await callback(directory);
-  } finally {
-    await import_promises4.default.rm(directory, { recursive: true, force: true });
-  }
-};
-var generateIndex = async (source, ref, checkout, executeFile) => checkout(source, ref, async (directory) => {
-  const { stdout } = await executeFile("git", ["rev-parse", "HEAD"], { cwd: directory, encoding: "utf8" });
-  const commit = stdout.trim();
-  const catalogDirectory = import_node_path11.default.resolve(directory, source.path ?? ".");
-  const relativeCatalogDirectory = import_node_path11.default.relative(directory, catalogDirectory);
-  if (relativeCatalogDirectory.startsWith("..") || import_node_path11.default.isAbsolute(relativeCatalogDirectory)) {
-    throw new Error(`Catalog path "${source.path}" escapes source "${source.id}"`);
-  }
-  const index = await (0, import_sdk.default)(catalogDirectory).buildIndex({ source: source.id, commit });
-  return { bytes: Buffer.from(JSON.stringify(index)), index, commit, generated: true };
-});
-var fetchPublishedIndex = async (source, ref, fetcher, token) => {
-  const indexPath = import_node_path11.default.posix.join(source.path ?? ".", "catalog.index.json");
-  const bytes = await fetchBytes(source, ref, indexPath, fetcher, token);
-  if (!bytes) return void 0;
-  const index = (0, import_sdk.parseIndex)(JSON.parse(bytes.toString("utf8")));
-  if (index.source !== source.id) {
-    throw new Error(`Published index source "${index.source}" does not match configured id "${source.id}"`);
-  }
-  return { bytes, index, commit: index.commit, generated: false };
-};
-var createGitHubSourceProvider = (options = {}) => {
-  const fetcher = options.fetch ?? ((url, init) => fetch(url, init));
-  const executeFile = options.execFile ?? ((file, args, execOptions) => execFileAsync(file, args, execOptions));
-  const configuredToken = options.token ?? process.env.EVENTCATALOG_GITHUB_TOKEN ?? process.env.GITHUB_TOKEN;
-  const token = configuredToken?.trim() || void 0;
-  const checkout = options.checkout ?? createCheckout(executeFile, token);
-  return {
-    async resolve(source) {
-      assertSafeCatalogPath(source);
-      const ref = source.ref ?? "main";
-      return await fetchPublishedIndex(source, ref, fetcher, token) ?? generateIndex(source, ref, checkout, executeFile);
-    },
-    async fetchContent({ source, commit, path: artifactPath }) {
-      assertSafeCatalogPath(source);
-      const catalogPath = import_node_path11.default.posix.join(source.path ?? ".", artifactPath);
-      const content = await fetchBytes(source, commit, catalogPath, fetcher, token);
-      if (!content) throw new Error(`Federated artifact not found for "${source.id}": ${artifactPath}`);
-      return content;
-    }
-  };
-};
-
 // src/federation/public-assets.ts
 var import_node_crypto2 = require("crypto");
 var import_promises5 = __toESM(require("fs/promises"), 1);
@@ -2142,6 +2076,232 @@ var composePublicAssets = async ({
   return { files, copied, skipped, overwritten, removed };
 };
 
+// src/federation/filesystem-source-provider.ts
+var import_node_crypto3 = require("crypto");
+var import_promises6 = __toESM(require("fs/promises"), 1);
+var import_node_path13 = __toESM(require("path"), 1);
+var import_sdk = __toESM(require("@eventcatalog/sdk"), 1);
+var FILESYSTEM_SOURCE_PREFIX = "file:";
+var isWithinDirectory = (directory, target) => {
+  const relativePath = import_node_path13.default.relative(directory, target);
+  return relativePath === "" || !relativePath.startsWith(`..${import_node_path13.default.sep}`) && relativePath !== ".." && !import_node_path13.default.isAbsolute(relativePath);
+};
+var assertPortableRelativePath = (filePath, label, allowRoot = true) => {
+  const portablePath = filePath.replaceAll("\\", "/");
+  const normalizedPath = import_node_path13.default.posix.normalize(portablePath);
+  const isUnsafe = filePath.includes("\\") || filePath.includes("\0") || import_node_path13.default.posix.isAbsolute(normalizedPath) || /^[a-zA-Z]:\//.test(normalizedPath) || normalizedPath === ".." || normalizedPath.startsWith("../") || !allowRoot && (normalizedPath === "." || normalizedPath === "");
+  if (isUnsafe) throw new Error(`${label} "${filePath}" escapes its filesystem source`);
+  return normalizedPath;
+};
+var getSourceRoot = (projectDirectory, source) => {
+  if (!source.source.startsWith(FILESYSTEM_SOURCE_PREFIX)) {
+    throw new Error(`Unsupported federation source "${source.source}". Expected file:path/to/catalog.`);
+  }
+  const locator = source.source.slice(FILESYSTEM_SOURCE_PREFIX.length);
+  if (!locator.trim()) throw new Error(`Filesystem federation source "${source.id}" requires a path after "file:".`);
+  return import_node_path13.default.resolve(projectDirectory, locator);
+};
+var getCatalogDirectory = async (projectDirectory, source) => {
+  if (source.ref) throw new Error(`Filesystem federation source "${source.id}" does not support "ref".`);
+  const sourceRoot = getSourceRoot(projectDirectory, source);
+  const catalogPath = assertPortableRelativePath(source.path ?? ".", "Catalog path");
+  const catalogDirectory = import_node_path13.default.resolve(sourceRoot, ...catalogPath.split("/"));
+  if (!isWithinDirectory(sourceRoot, catalogDirectory)) {
+    throw new Error(`Catalog path "${source.path}" escapes source "${source.id}"`);
+  }
+  try {
+    const [realSourceRoot, realCatalogDirectory] = await Promise.all([import_promises6.default.realpath(sourceRoot), import_promises6.default.realpath(catalogDirectory)]);
+    if (!isWithinDirectory(realSourceRoot, realCatalogDirectory)) {
+      throw new Error(`Catalog path "${source.path}" escapes source "${source.id}"`);
+    }
+    if (!(await import_promises6.default.stat(realCatalogDirectory)).isDirectory()) {
+      throw new Error(`Filesystem federation source "${source.id}" is not a directory: ${catalogDirectory}`);
+    }
+    return realCatalogDirectory;
+  } catch (error) {
+    if (error.code === "ENOENT") {
+      throw new Error(`Filesystem federation source "${source.id}" does not exist: ${catalogDirectory}`, { cause: error });
+    }
+    throw error;
+  }
+};
+var getArtifactPath = async (catalogDirectory, source, artifactPath) => {
+  const normalizedPath = assertPortableRelativePath(artifactPath, "Federated artifact path", false);
+  const filePath = import_node_path13.default.resolve(catalogDirectory, ...normalizedPath.split("/"));
+  if (!isWithinDirectory(catalogDirectory, filePath)) {
+    throw new Error(`Federated artifact path "${artifactPath}" escapes source "${source.id}"`);
+  }
+  try {
+    const realFilePath = await import_promises6.default.realpath(filePath);
+    if (!isWithinDirectory(catalogDirectory, realFilePath)) {
+      throw new Error(`Federated artifact path "${artifactPath}" escapes source "${source.id}"`);
+    }
+    return realFilePath;
+  } catch (error) {
+    if (error.code === "ENOENT") {
+      throw new Error(`Federated artifact not found for "${source.id}": ${artifactPath}`, { cause: error });
+    }
+    throw error;
+  }
+};
+var createFileSystemSourceProvider = (projectDirectory) => ({
+  async resolve(source) {
+    const catalogDirectory = await getCatalogDirectory(projectDirectory, source);
+    const localIndex = await (0, import_sdk.default)(catalogDirectory).buildIndex({
+      source: source.id,
+      commit: "local",
+      includeFederated: false
+    });
+    const snapshot = (0, import_node_crypto3.createHash)("sha256").update(JSON.stringify(localIndex)).digest("hex").slice(0, 12);
+    const index = { ...localIndex, commit: `local:${snapshot}` };
+    const bytes = Buffer.from(JSON.stringify(index));
+    return { bytes, index, commit: index.commit, generated: true };
+  },
+  async fetchContent({ source, path: artifactPath }) {
+    const catalogDirectory = await getCatalogDirectory(projectDirectory, source);
+    return import_promises6.default.readFile(await getArtifactPath(catalogDirectory, source, artifactPath));
+  }
+});
+
+// src/federation/github-source-provider.ts
+var import_node_child_process = require("child_process");
+var import_promises7 = __toESM(require("fs/promises"), 1);
+var import_node_os4 = __toESM(require("os"), 1);
+var import_node_path14 = __toESM(require("path"), 1);
+var import_node_util = require("util");
+var import_sdk2 = __toESM(require("@eventcatalog/sdk"), 1);
+var execFileAsync = (0, import_node_util.promisify)(import_node_child_process.execFile);
+var parseGitHubSource = (source) => {
+  const match = /^github:([^/]+)\/(.+)$/.exec(source.source);
+  if (!match) throw new Error(`Unsupported federation source "${source.source}". Expected github:owner/repository.`);
+  return { owner: match[1], repository: match[2] };
+};
+var assertSafeCatalogPath = (source) => {
+  const catalogPath = source.path ?? ".";
+  const normalized = import_node_path14.default.posix.normalize(catalogPath.replaceAll("\\", "/"));
+  if (catalogPath.includes("\\") || import_node_path14.default.posix.isAbsolute(normalized) || normalized === ".." || normalized.startsWith("../")) {
+    throw new Error(`Catalog path "${catalogPath}" escapes source "${source.id}"`);
+  }
+};
+var encodePath = (value) => value.split("/").filter(Boolean).map(encodeURIComponent).join("/");
+var rawUrl = (source, ref, filePath) => {
+  const { owner, repository } = parseGitHubSource(source);
+  return `https://raw.githubusercontent.com/${encodeURIComponent(owner)}/${encodeURIComponent(repository)}/${encodeURIComponent(
+    ref
+  )}/${encodePath(filePath)}`;
+};
+var contentsApiUrl = (source, ref, filePath) => {
+  const { owner, repository } = parseGitHubSource(source);
+  return `https://api.github.com/repos/${encodeURIComponent(owner)}/${encodeURIComponent(repository)}/contents/${encodePath(
+    filePath
+  )}?ref=${encodeURIComponent(ref)}`;
+};
+var fetchBytes = async (source, ref, filePath, fetcher, token) => {
+  const url = token ? contentsApiUrl(source, ref, filePath) : rawUrl(source, ref, filePath);
+  const response = token ? await fetcher(url, {
+    headers: {
+      Accept: "application/vnd.github.raw+json",
+      Authorization: `Bearer ${token}`,
+      "X-GitHub-Api-Version": "2026-03-10"
+    }
+  }) : await fetcher(url);
+  if (response.status === 404) return void 0;
+  if (!response.ok) throw new Error(`Failed to fetch ${url}: ${response.status} ${response.statusText}`);
+  return Buffer.from(await response.arrayBuffer());
+};
+var getGitEnvironment = (token) => {
+  if (!token) return process.env;
+  const inheritedCount = Number.parseInt(process.env.GIT_CONFIG_COUNT ?? "0", 10);
+  const configIndex = Number.isInteger(inheritedCount) && inheritedCount >= 0 ? inheritedCount : 0;
+  return {
+    ...process.env,
+    GIT_CONFIG_COUNT: String(configIndex + 1),
+    [`GIT_CONFIG_KEY_${configIndex}`]: "http.https://github.com/.extraheader",
+    [`GIT_CONFIG_VALUE_${configIndex}`]: `AUTHORIZATION: basic ${Buffer.from(`x-access-token:${token}`).toString("base64")}`
+  };
+};
+var createCheckout = (executeFile, token) => async (source, ref, callback) => {
+  const { owner, repository } = parseGitHubSource(source);
+  const catalogPath = import_node_path14.default.posix.normalize(source.path ?? ".");
+  const directory = await import_promises7.default.mkdtemp(import_node_path14.default.join(import_node_os4.default.tmpdir(), "eventcatalog-federation-"));
+  const env = getGitEnvironment(token);
+  try {
+    const git = (args) => executeFile("git", args, { cwd: directory, env, encoding: "utf8" });
+    await git(["init", "--quiet"]);
+    await git(["remote", "add", "origin", `https://github.com/${owner}/${repository}.git`]);
+    if (catalogPath !== ".") {
+      await git(["sparse-checkout", "init", "--cone"]);
+      await git(["sparse-checkout", "set", catalogPath]);
+    }
+    await git(["fetch", "--quiet", "--depth", "1", "origin", ref]);
+    await git(["checkout", "--quiet", "--detach", "FETCH_HEAD"]);
+    return await callback(directory);
+  } finally {
+    await import_promises7.default.rm(directory, { recursive: true, force: true });
+  }
+};
+var generateIndex = async (source, ref, checkout, executeFile) => checkout(source, ref, async (directory) => {
+  const { stdout } = await executeFile("git", ["rev-parse", "HEAD"], { cwd: directory, encoding: "utf8" });
+  const commit = stdout.trim();
+  const catalogDirectory = import_node_path14.default.resolve(directory, source.path ?? ".");
+  const relativeCatalogDirectory = import_node_path14.default.relative(directory, catalogDirectory);
+  if (relativeCatalogDirectory.startsWith("..") || import_node_path14.default.isAbsolute(relativeCatalogDirectory)) {
+    throw new Error(`Catalog path "${source.path}" escapes source "${source.id}"`);
+  }
+  const index = await (0, import_sdk2.default)(catalogDirectory).buildIndex({ source: source.id, commit });
+  return { bytes: Buffer.from(JSON.stringify(index)), index, commit, generated: true };
+});
+var fetchPublishedIndex = async (source, ref, fetcher, token) => {
+  const indexPath = import_node_path14.default.posix.join(source.path ?? ".", "catalog.index.json");
+  const bytes = await fetchBytes(source, ref, indexPath, fetcher, token);
+  if (!bytes) return void 0;
+  const index = (0, import_sdk2.parseIndex)(JSON.parse(bytes.toString("utf8")));
+  if (index.source !== source.id) {
+    throw new Error(`Published index source "${index.source}" does not match configured id "${source.id}"`);
+  }
+  return { bytes, index, commit: index.commit, generated: false };
+};
+var createGitHubSourceProvider = (options = {}) => {
+  const fetcher = options.fetch ?? ((url, init) => fetch(url, init));
+  const executeFile = options.execFile ?? ((file, args, execOptions) => execFileAsync(file, args, execOptions));
+  const configuredToken = options.token ?? process.env.EVENTCATALOG_GITHUB_TOKEN ?? process.env.GITHUB_TOKEN;
+  const token = configuredToken?.trim() || void 0;
+  const checkout = options.checkout ?? createCheckout(executeFile, token);
+  return {
+    async resolve(source) {
+      assertSafeCatalogPath(source);
+      const ref = source.ref ?? "main";
+      return await fetchPublishedIndex(source, ref, fetcher, token) ?? generateIndex(source, ref, checkout, executeFile);
+    },
+    async fetchContent({ source, commit, path: artifactPath }) {
+      assertSafeCatalogPath(source);
+      const catalogPath = import_node_path14.default.posix.join(source.path ?? ".", artifactPath);
+      const content = await fetchBytes(source, commit, catalogPath, fetcher, token);
+      if (!content) throw new Error(`Federated artifact not found for "${source.id}": ${artifactPath}`);
+      return content;
+    }
+  };
+};
+
+// src/federation/source-provider.ts
+var createFederationSourceProvider = (projectDirectory, providers = {}) => {
+  const github = providers.github ?? createGitHubSourceProvider();
+  const filesystem = providers.filesystem ?? createFileSystemSourceProvider(projectDirectory);
+  const getProvider = (source) => {
+    if (source.source.startsWith("github:")) return github;
+    if (source.source.startsWith("file:")) return filesystem;
+    throw new Error(`Unsupported federation source "${source.source}" for "${source.id}". Supported protocols: github:, file:.`);
+  };
+  return {
+    async resolve(source) {
+      return getProvider(source).resolve(source);
+    },
+    async fetchContent(request) {
+      return getProvider(request.source).fetchContent(request);
+    }
+  };
+};
+
 // src/federation/federate.ts
 var FederationConflictError = class extends Error {
   conflicts;
@@ -2164,16 +2324,16 @@ var validateSources = (sources) => {
 var writeLock = async (lockPath, lock) => {
   const temporaryPath = `${lockPath}.tmp-${process.pid}`;
   try {
-    await import_promises6.default.writeFile(temporaryPath, `${JSON.stringify(lock, null, 2)}
+    await import_promises8.default.writeFile(temporaryPath, `${JSON.stringify(lock, null, 2)}
 `, "utf8");
-    await import_promises6.default.rename(temporaryPath, lockPath);
+    await import_promises8.default.rename(temporaryPath, lockPath);
   } finally {
-    await import_promises6.default.rm(temporaryPath, { force: true });
+    await import_promises8.default.rm(temporaryPath, { force: true });
   }
 };
 var readLock = async (lockPath) => {
   try {
-    return JSON.parse(await import_promises6.default.readFile(lockPath, "utf8"));
+    return JSON.parse(await import_promises8.default.readFile(lockPath, "utf8"));
   } catch (error) {
     if (error.code === "ENOENT") return void 0;
     throw new Error(`Cannot read federation lock at "${lockPath}"`, { cause: error });
@@ -2181,7 +2341,7 @@ var readLock = async (lockPath) => {
 };
 var pathExists2 = async (filePath) => {
   try {
-    await import_promises6.default.access(filePath);
+    await import_promises8.default.access(filePath);
     return true;
   } catch (error) {
     if (error.code === "ENOENT") return false;
@@ -2189,20 +2349,20 @@ var pathExists2 = async (filePath) => {
   }
 };
 var cleanupPreviousFederation = async (projectDirectory, onProgress) => {
-  const outDir = import_node_path13.default.join(projectDirectory, "federated");
-  const lockPath = import_node_path13.default.join(projectDirectory, "eventcatalog.lock");
+  const outDir = import_node_path15.default.join(projectDirectory, "federated");
+  const lockPath = import_node_path15.default.join(projectDirectory, "eventcatalog.lock");
   const previousLock = await readLock(lockPath);
   const hadFederatedOutput = await pathExists2(outDir);
   const hadLock = previousLock !== void 0;
   if (!hadFederatedOutput && !hadLock) return;
-  await import_promises6.default.rm(outDir, { recursive: true, force: true });
+  await import_promises8.default.rm(outDir, { recursive: true, force: true });
   const publicResult = await composePublicAssets({
     projectDirectory,
     federatedDirectory: outDir,
     assets: [],
     previousFiles: previousLock?.publicFiles
   });
-  await import_promises6.default.rm(lockPath, { force: true });
+  await import_promises8.default.rm(lockPath, { force: true });
   onProgress?.({
     type: "cleanup:complete",
     federated: hadFederatedOutput,
@@ -2225,7 +2385,7 @@ var federateCatalog = async (projectDirectory, options = {}) => {
   }
   validateSources(sources);
   if (options.useCache === false) options.onProgress?.({ type: "cache:disabled" });
-  const provider = options.provider ?? createGitHubSourceProvider();
+  const provider = options.provider ?? createFederationSourceProvider(projectDirectory);
   const resolvedSources = [];
   for (const [index, source] of sources.entries()) {
     const current = index + 1;
@@ -2247,13 +2407,13 @@ var federateCatalog = async (projectDirectory, options = {}) => {
       throw new Error(`Failed to federate source "${source.id}": ${message}`, { cause: error });
     }
   }
-  const outDir = import_node_path13.default.join(projectDirectory, "federated");
-  const lockPath = import_node_path13.default.join(projectDirectory, "eventcatalog.lock");
+  const outDir = import_node_path15.default.join(projectDirectory, "federated");
+  const lockPath = import_node_path15.default.join(projectDirectory, "eventcatalog.lock");
   const previousLock = await readLock(lockPath);
   const resources = resolvedSources.reduce((total, source) => total + source.resolved.index.resources.length, 0);
   const remoteIndexes = resolvedSources.map(({ resolved }) => resolved.index);
   options.onProgress?.({ type: "local:start" });
-  const localIndex = await (0, import_sdk2.default)(projectDirectory).buildIndex({
+  const localIndex = await (0, import_sdk3.default)(projectDirectory).buildIndex({
     source: config.cId,
     commit: "local",
     hashContent: false,
@@ -2261,18 +2421,18 @@ var federateCatalog = async (projectDirectory, options = {}) => {
   });
   options.onProgress?.({ type: "local:complete", resources: localIndex.resources.length });
   options.onProgress?.({ type: "resolving", resources, localResources: localIndex.resources.length });
-  const ownershipGraph = (0, import_sdk2.resolve)([localIndex, ...remoteIndexes]);
+  const ownershipGraph = (0, import_sdk3.resolve)([localIndex, ...remoteIndexes]);
   if (ownershipGraph.conflicts.length > 0) {
     options.onProgress?.({ type: "resolved", graph: ownershipGraph });
     throw new FederationConflictError(ownershipGraph.conflicts);
   }
-  const graph = (0, import_sdk2.resolve)(remoteIndexes);
+  const graph = (0, import_sdk3.resolve)(remoteIndexes);
   options.onProgress?.({ type: "resolved", graph });
   const sourcesById = new Map(sources.map((source) => [source.id, source]));
   options.onProgress?.({ type: "hydrating", outDir });
   let hydratedFiles = 0;
   let cachedFiles = 0;
-  const hydrateResult = await (0, import_sdk2.hydrate)(graph, {
+  const hydrateResult = await (0, import_sdk3.hydrate)(graph, {
     outDir,
     cache: createFederationContentCache(projectDirectory, {
       read: options.useCache !== false,
@@ -2306,7 +2466,7 @@ var federateCatalog = async (projectDirectory, options = {}) => {
     lockVersion: 1,
     sources: resolvedSources.map(({ config: source, resolved }) => ({
       id: source.id,
-      digest: `sha256:${(0, import_node_crypto3.createHash)("sha256").update(resolved.bytes).digest("hex")}`,
+      digest: `sha256:${(0, import_node_crypto4.createHash)("sha256").update(resolved.bytes).digest("hex")}`,
       commit: resolved.commit,
       resolvedAt
     })).sort((left, right) => left.id.localeCompare(right.id)),
@@ -2327,14 +2487,14 @@ var federateCatalog = async (projectDirectory, options = {}) => {
 
 // src/eventcatalog.ts
 var import_license = require("@eventcatalog/license");
-var currentDir = import_node_path15.default.dirname((0, import_node_url.fileURLToPath)(importMetaUrl));
+var currentDir = import_node_path17.default.dirname((0, import_node_url.fileURLToPath)(importMetaUrl));
 var program = new import_commander.Command().version(VERSION);
-var dir = import_node_path15.default.resolve(process.env.PROJECT_DIR || process.cwd());
-var core = import_node_path15.default.resolve(process.env.CATALOG_DIR || (0, import_node_path14.join)(dir, ".eventcatalog-core"));
-var eventCatalogDir = import_node_path15.default.resolve((0, import_node_path14.join)(currentDir, "../eventcatalog/"));
+var dir = import_node_path17.default.resolve(process.env.PROJECT_DIR || process.cwd());
+var core = import_node_path17.default.resolve(process.env.CATALOG_DIR || (0, import_node_path16.join)(dir, ".eventcatalog-core"));
+var eventCatalogDir = import_node_path17.default.resolve((0, import_node_path16.join)(currentDir, "../eventcatalog/"));
 var getInstalledEventCatalogVersion = () => {
   try {
-    const pkg = import_fs3.default.readFileSync((0, import_node_path14.join)(dir, "package.json"), "utf8");
+    const pkg = import_fs3.default.readFileSync((0, import_node_path16.join)(dir, "package.json"), "utf8");
     const json = JSON.parse(pkg);
     return json.dependencies["@eventcatalog/core"];
   } catch (error) {
@@ -2400,12 +2560,12 @@ var startDevPrewarm = ({
 var buildDevSearchIndex = async ({ config }) => {
   const result = await buildSearchIndex({
     projectDir: dir,
-    outDir: import_node_path15.default.join(core, "public"),
-    searchOutputPath: import_node_path15.default.join(core, "public", "pagefind"),
+    outDir: import_node_path17.default.join(core, "public"),
+    searchOutputPath: import_node_path17.default.join(core, "public", "pagefind"),
     config,
     isServer: false
   });
-  logger.info(`Indexed ${result.records} page(s) into ${import_node_path15.default.relative(core, result.outputPath)}`, "search");
+  logger.info(`Indexed ${result.records} page(s) into ${import_node_path17.default.relative(core, result.outputPath)}`, "search");
 };
 var warnIfIndexedSearchUsesAuth = async () => {
   if (!await isAuthEnabled()) {
@@ -2520,12 +2680,12 @@ var copyCore = () => {
   import_fs3.default.cpSync(eventCatalogDir, core, {
     recursive: true,
     filter: (src) => {
-      const relativePath = import_node_path15.default.relative(eventCatalogDir, src);
-      const pathParts = relativePath.split(import_node_path15.default.sep);
+      const relativePath = import_node_path17.default.relative(eventCatalogDir, src);
+      const pathParts = relativePath.split(import_node_path17.default.sep);
       return !pathParts.some((part) => [".astro", "dist", "node_modules"].includes(part));
     }
   });
-  const coreNodeModules = import_node_path15.default.join(core, "node_modules");
+  const coreNodeModules = import_node_path17.default.join(core, "node_modules");
   const installedCoreNodeModules = resolveInstalledCoreNodeModules(currentDir);
   linkCoreNodeModules({ coreNodeModules, installedCoreNodeModules });
 };
@@ -2584,8 +2744,8 @@ program.command("dev").description("Run development server of EventCatalog").opt
   logger.info("Setting up EventCatalog...", "eventcatalog");
   const isServer = await isOutputServer();
   logger.info(isServer ? "EventCatalog is running in Server Mode" : "EventCatalog is running in Static Mode", "config");
-  if (import_fs3.default.existsSync(import_node_path15.default.join(dir, ".env"))) {
-    import_dotenv.default.config({ path: import_node_path15.default.join(dir, ".env") });
+  if (import_fs3.default.existsSync(import_node_path17.default.join(dir, ".env"))) {
+    import_dotenv.default.config({ path: import_node_path17.default.join(dir, ".env") });
   }
   if (options.debug) {
     logger.info("Debug mode enabled", "debug");
@@ -2665,8 +2825,8 @@ program.command("build").description("Run build of EventCatalog").action(async (
   logger.info("Building EventCatalog...", "build");
   const isServer = await isOutputServer();
   logger.info(isServer ? "EventCatalog is running in Server Mode" : "EventCatalog is running in Static Mode", "config");
-  if (import_fs3.default.existsSync(import_node_path15.default.join(dir, ".env"))) {
-    import_dotenv.default.config({ path: import_node_path15.default.join(dir, ".env") });
+  if (import_fs3.default.existsSync(import_node_path17.default.join(dir, ".env"))) {
+    import_dotenv.default.config({ path: import_node_path17.default.join(dir, ".env") });
   }
   await verifyRequiredFieldsAreInCatalogConfigFile(dir);
   copyCore();
@@ -2716,7 +2876,7 @@ program.command("build").description("Run build of EventCatalog").action(async (
   if (await isIndexedSearchEnabled()) {
     await warnIfIndexedSearchUsesAuth();
     const config = await getEventCatalogConfigFile(dir);
-    const outDir = import_node_path15.default.resolve(dir, await getProjectOutDir());
+    const outDir = import_node_path17.default.resolve(dir, await getProjectOutDir());
     logger.info("Building indexed search...", "search");
     const result = await buildSearchIndex({
       projectDir: dir,
@@ -2724,7 +2884,7 @@ program.command("build").description("Run build of EventCatalog").action(async (
       config,
       isServer
     });
-    logger.info(`Indexed ${result.records} page(s) into ${import_node_path15.default.relative(dir, result.outputPath)}`, "search");
+    logger.info(`Indexed ${result.records} page(s) into ${import_node_path17.default.relative(dir, result.outputPath)}`, "search");
   }
 });
 var previewCatalog = async ({
@@ -2751,7 +2911,7 @@ var startServerCatalog = async ({
   isEventCatalogStarter = false,
   isEventCatalogScale = false
 }) => {
-  const serverEntryPath = import_node_path15.default.join(dir, "dist", "server", "entry.mjs");
+  const serverEntryPath = import_node_path17.default.join(dir, "dist", "server", "entry.mjs");
   await runCommandWithFilteredOutput({
     command: `node "${serverEntryPath}"`,
     cwd: core,
@@ -2768,8 +2928,8 @@ var startServerCatalog = async ({
 program.command("preview").description("Serves the contents of your eventcatalog build directory").action(async (options, command) => {
   logger.welcome();
   logger.info("Starting preview of your build...", "preview");
-  if (import_fs3.default.existsSync(import_node_path15.default.join(dir, ".env"))) {
-    import_dotenv.default.config({ path: import_node_path15.default.join(dir, ".env") });
+  if (import_fs3.default.existsSync(import_node_path17.default.join(dir, ".env"))) {
+    import_dotenv.default.config({ path: import_node_path17.default.join(dir, ".env") });
   }
   const canEmbedPages = await (0, import_license.isFeatureEnabled)(
     "@eventcatalog/backstage-plugin-eventcatalog",
@@ -2787,8 +2947,8 @@ program.command("preview").description("Serves the contents of your eventcatalog
 program.command("start").description("Serves the contents of your eventcatalog build directory").action(async (options, command) => {
   logger.welcome();
   logger.info("Starting preview of your build...", "preview");
-  if (import_fs3.default.existsSync(import_node_path15.default.join(dir, ".env"))) {
-    import_dotenv.default.config({ path: import_node_path15.default.join(dir, ".env") });
+  if (import_fs3.default.existsSync(import_node_path17.default.join(dir, ".env"))) {
+    import_dotenv.default.config({ path: import_node_path17.default.join(dir, ".env") });
   }
   const canEmbedPages = await (0, import_license.isFeatureEnabled)(
     "@eventcatalog/backstage-plugin-eventcatalog",
@@ -2815,22 +2975,22 @@ program.command("start").description("Serves the contents of your eventcatalog b
 program.command("export").description("Export your EventCatalog using the SDK dumpCatalog function").option("--include-markdown", "Include markdown content in the export", false).action(async (options) => {
   logger.welcome();
   logger.info("Exporting EventCatalog...", "export");
-  if (import_fs3.default.existsSync(import_node_path15.default.join(dir, ".env"))) {
-    import_dotenv.default.config({ path: import_node_path15.default.join(dir, ".env") });
+  if (import_fs3.default.existsSync(import_node_path17.default.join(dir, ".env"))) {
+    import_dotenv.default.config({ path: import_node_path17.default.join(dir, ".env") });
   }
   const { default: initSDK } = await import("@eventcatalog/sdk");
   const sdk = initSDK(dir);
   const catalog = await sdk.dumpCatalog({ includeMarkdown: options.includeMarkdown });
-  const exportsDir = import_node_path15.default.join(dir, "exports");
+  const exportsDir = import_node_path17.default.join(dir, "exports");
   ensureDir(exportsDir);
   const date = (/* @__PURE__ */ new Date()).toISOString().split("T")[0];
-  const exportFile = import_node_path15.default.join(exportsDir, `catalog-${date}.json`);
+  const exportFile = import_node_path17.default.join(exportsDir, `catalog-${date}.json`);
   import_fs3.default.writeFileSync(exportFile, JSON.stringify(catalog, null, 2), "utf-8");
   logger.info(`Catalog exported to ${exportFile}`, "export");
 });
 program.command("generate [siteDir]").description("Start the generator scripts.").action(async () => {
-  if (import_fs3.default.existsSync(import_node_path15.default.join(dir, ".env"))) {
-    import_dotenv.default.config({ path: import_node_path15.default.join(dir, ".env") });
+  if (import_fs3.default.existsSync(import_node_path17.default.join(dir, ".env"))) {
+    import_dotenv.default.config({ path: import_node_path17.default.join(dir, ".env") });
   }
   await generate(dir);
 });
@@ -2905,7 +3065,7 @@ var reportFederationProgress = (event) => {
       }
       return;
     case "hydrating":
-      logger.info(`Hydrating federated content into ${import_node_path15.default.relative(dir, event.outDir)}/...`, "federation");
+      logger.info(`Hydrating federated content into ${import_node_path17.default.relative(dir, event.outDir)}/...`, "federation");
       return;
     case "hydrate:cache":
       if (event.files === 1 || event.files % 25 === 0) {
@@ -2934,13 +3094,13 @@ var reportFederationProgress = (event) => {
         `Federation complete: ${event.result.sources} sources, ${event.result.resources} remote resources, ${event.result.hydrate.written} files written (${event.result.hydrate.fetched} downloaded, ${event.result.hydrate.written - event.result.hydrate.fetched} cached)`,
         "federation"
       );
-      logger.info(`Pinned source commits in ${import_node_path15.default.relative(dir, event.result.lockPath)}`, "federation");
+      logger.info(`Pinned source commits in ${import_node_path17.default.relative(dir, event.result.lockPath)}`, "federation");
   }
 };
 program.command("federate").description("Fetch, resolve, and hydrate the catalogs configured in federation.sources.").option("--no-cache", "Download all federation content and refresh the cache.").action(async (commandOptions) => {
   logger.welcome();
-  if (import_fs3.default.existsSync(import_node_path15.default.join(dir, ".env"))) {
-    import_dotenv.default.config({ path: import_node_path15.default.join(dir, ".env") });
+  if (import_fs3.default.existsSync(import_node_path17.default.join(dir, ".env"))) {
+    import_dotenv.default.config({ path: import_node_path17.default.join(dir, ".env") });
   }
   logger.info("Starting federation...", "federation");
   let cleanedPreviousOutput = false;