@eventcatalog/core 3.35.1 → 3.36.1

package/dist/analytics/analytics.cjs

@@ -37,7 +37,7 @@ var import_axios = __toESM(require("axios"), 1);
 var import_os = __toESM(require("os"), 1);
 
 // package.json
-var version = "3.35.1";
+var version = "3.36.1";
 
 // src/constants.ts
 var VERSION = version;

package/dist/analytics/analytics.js

@@ -1,7 +1,7 @@
 import {
   raiseEvent
-} from "../chunk-VJ357XOI.js";
-import "../chunk-B7C4DHFE.js";
+} from "../chunk-V22QY5Q3.js";
+import "../chunk-C7JCOHTI.js";
 export {
   raiseEvent
 };

package/dist/analytics/log-build.cjs

@@ -111,7 +111,7 @@ var import_axios = __toESM(require("axios"), 1);
 var import_os = __toESM(require("os"), 1);
 
 // package.json
-var version = "3.35.1";
+var version = "3.36.1";
 
 // src/constants.ts
 var VERSION = version;

package/dist/analytics/log-build.js

@@ -1,9 +1,9 @@
 import {
   log_build_default
-} from "../chunk-JEQZWJWP.js";
-import "../chunk-VJ357XOI.js";
+} from "../chunk-UJ7DX4SA.js";
 import "../chunk-4UVFXLPI.js";
-import "../chunk-B7C4DHFE.js";
+import "../chunk-V22QY5Q3.js";
+import "../chunk-C7JCOHTI.js";
 import "../chunk-5T63CXKU.js";
 export {
   log_build_default as default

package/dist/{chunk-4SNN54V4.js → chunk-6D65JSOA.js}

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

package/dist/{chunk-B7C4DHFE.js → chunk-C7JCOHTI.js}

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

package/dist/chunk-D6IBLY3O.js

@@ -0,0 +1,320 @@
+// src/search-indexer.ts
+import fs from "fs/promises";
+import path from "path";
+import { glob } from "glob";
+import matter from "gray-matter";
+var RESOURCE_COLLECTIONS = {
+  channels: { docsPath: "channels", type: "Channel" },
+  commands: { docsPath: "commands", type: "Command" },
+  containers: { docsPath: "containers", type: "Container" },
+  "data-products": { docsPath: "data-products", type: "Data Product" },
+  domains: { docsPath: "domains", type: "Domain" },
+  entities: { docsPath: "entities", type: "Entity" },
+  events: { docsPath: "events", type: "Event" },
+  flows: { docsPath: "flows", type: "Flow" },
+  queries: { docsPath: "queries", type: "Query" },
+  services: { docsPath: "services", type: "Service" },
+  subdomains: { docsPath: "domains", type: "Domain" }
+};
+var IGNORED_GLOBS = [
+  "**/.git/**",
+  "**/.eventcatalog-core/**",
+  "**/dist/**",
+  "**/node_modules/**",
+  "**/public/**",
+  "**/snippets/**",
+  "**/chat-prompts/**"
+];
+var trimSlashes = (value) => value.replace(/^\/+|\/+$/g, "");
+var normalizePath = (value) => value.replace(/\\/g, "/");
+var removeExtension = (value) => value.replace(/\.(md|mdx)$/i, "");
+var stripNumericPrefix = (value) => value.replace(/^\d+(?:[-_.\s]+)?/, "") || value;
+var normalizeUrlPath = (value) => {
+  const withoutIndex = value.replace(/\/index$/i, "");
+  return withoutIndex || "";
+};
+var buildUrl = (pathname, config) => {
+  const base = config.base ? `/${trimSlashes(config.base)}` : "";
+  const cleanPath = `/${trimSlashes(pathname)}`;
+  const url = `${base}${cleanPath}`.replace(/\/{2,}/g, "/");
+  if (config.trailingSlash === true && !url.endsWith("/")) {
+    return `${url}/`;
+  }
+  return url || "/";
+};
+var valueToSearchText = (value) => {
+  if (value === null || value === void 0) return "";
+  if (typeof value === "string" || typeof value === "number" || typeof value === "boolean") return String(value);
+  if (Array.isArray(value)) return value.map(valueToSearchText).filter(Boolean).join(" ");
+  if (typeof value === "object") return Object.values(value).map(valueToSearchText).filter(Boolean).join(" ");
+  return "";
+};
+var markdownToSearchText = (content) => {
+  return content.replace(/<!--[\s\S]*?-->/g, " ").replace(/^\s*import\s+.*$/gm, " ").replace(/^\s*export\s+.*$/gm, " ").replace(/```[\s\S]*?```/g, (match) => match.replace(/```[a-zA-Z0-9-]*\n?/g, " ").replace(/```/g, " ")).replace(/<([A-Z][A-Za-z0-9.]*)\b([^>]*)\/?>/g, (_match, _component, attributes) => {
+    const quotedValues = [...String(attributes).matchAll(/(?:title|label|description|alt|summary)=["'`]([^"'`]+)["'`]/g)];
+    return quotedValues.map((entry) => entry[1]).join(" ");
+  }).replace(/<\/?[A-Za-z][^>]*>/g, " ").replace(/\[\[([^|\]]+)\|([^\]]+)\]\]/g, "$2").replace(/\[([^\]]+)\]\([^)]+\)/g, "$1").replace(/[`*_~>#|{}[\]():]/g, " ").replace(/\s+/g, " ").trim();
+};
+var inferDocIdFromFile = (relativePath, frontmatterId) => {
+  if (frontmatterId) return frontmatterId;
+  const fileName = path.posix.basename(removeExtension(relativePath));
+  if (fileName.toLowerCase() === "index") {
+    return path.posix.basename(path.posix.dirname(relativePath));
+  }
+  return stripNumericPrefix(fileName);
+};
+var findResourceSegment = (segments) => {
+  let match = null;
+  for (let index = 0; index < segments.length - 1; index++) {
+    const segment = segments[index];
+    if (RESOURCE_COLLECTIONS[segment] && segments[index + 1]) {
+      match = { index, segment };
+    }
+  }
+  return match;
+};
+var readResourceFrontmatter = async (projectDir, resourcePath) => {
+  const candidates = [path.join(projectDir, resourcePath, "index.mdx"), path.join(projectDir, resourcePath, "index.md")];
+  for (const candidate of candidates) {
+    try {
+      const file = await fs.readFile(candidate, "utf8");
+      return matter(file).data;
+    } catch {
+    }
+  }
+  return {};
+};
+var deriveRecordFromPath = async ({
+  projectDir,
+  relativePath,
+  data,
+  config
+}) => {
+  const normalizedRelativePath = normalizePath(relativePath);
+  const segments = normalizedRelativePath.split("/").filter(Boolean);
+  const fileName = segments[segments.length - 1] || "";
+  const fileNameWithoutExtension = removeExtension(fileName);
+  if (data.hidden === true || data.draft) {
+    return null;
+  }
+  if (segments[0] === "docs") {
+    const customPath = normalizeUrlPath(removeExtension(segments.slice(1).join("/")));
+    const title = data.title || data.label || path.posix.basename(customPath) || "Custom docs";
+    return {
+      url: buildUrl(`/docs/custom/${customPath}`, config),
+      title,
+      summary: data.summary,
+      type: "Custom Doc",
+      collection: "custom-docs",
+      id: customPath
+    };
+  }
+  if (segments[0] === "users" || segments[0] === "teams") {
+    const id = data.id || (fileNameWithoutExtension === "index" ? segments[1] : fileNameWithoutExtension);
+    const type = segments[0] === "users" ? "User" : "Team";
+    return {
+      url: buildUrl(`/docs/${segments[0]}/${id}`, config),
+      title: data.name || data.title || id,
+      summary: data.summary,
+      type,
+      collection: segments[0],
+      id
+    };
+  }
+  const resourceMatch = findResourceSegment(segments);
+  if (!resourceMatch) {
+    return null;
+  }
+  const resourceConfig = RESOURCE_COLLECTIONS[resourceMatch.segment];
+  const resourceFolderId = segments[resourceMatch.index + 1];
+  const resourcePathSegments = segments.slice(0, resourceMatch.index + 2);
+  const versionFromPath = segments[resourceMatch.index + 2] === "versioned" && segments[resourceMatch.index + 3] ? segments[resourceMatch.index + 3] : void 0;
+  if (versionFromPath) {
+    resourcePathSegments.push("versioned", versionFromPath);
+  }
+  const resourcePath = resourcePathSegments.join("/");
+  const resourceData = fileNameWithoutExtension === "index" ? data : await readResourceFrontmatter(projectDir, resourcePath);
+  const resourceId = resourceData.id || data.resourceId || resourceFolderId;
+  const resourceVersion = versionFromPath || resourceData.version || data.resourceVersion || data.version;
+  if (!resourceVersion) {
+    return null;
+  }
+  if (fileNameWithoutExtension === "index") {
+    return {
+      url: buildUrl(`/docs/${resourceConfig.docsPath}/${resourceId}/${resourceVersion}`, config),
+      title: data.name || data.title || resourceId,
+      summary: data.summary,
+      type: resourceConfig.type,
+      collection: resourceConfig.docsPath,
+      id: resourceId,
+      version: resourceVersion
+    };
+  }
+  if (fileNameWithoutExtension === "ubiquitous-language") {
+    return {
+      url: buildUrl(`/docs/${resourceConfig.docsPath}/${resourceId}/language`, config),
+      title: data.title || `${resourceData.name || resourceId} ubiquitous language`,
+      summary: data.summary,
+      type: "Language",
+      collection: "language",
+      id: resourceId,
+      version: resourceVersion
+    };
+  }
+  if (fileNameWithoutExtension === "changelog") {
+    return {
+      url: buildUrl(`/docs/${resourceConfig.docsPath}/${resourceId}/${resourceVersion}/changelog`, config),
+      title: data.title || `${resourceData.name || resourceId} changelog`,
+      summary: data.summary,
+      type: "Changelog",
+      collection: "changelog",
+      id: resourceId,
+      version: resourceVersion
+    };
+  }
+  const docsIndex = segments.indexOf("docs");
+  if (docsIndex > resourceMatch.index) {
+    const docType = data.type || segments[docsIndex + 1] || "pages";
+    const docId = inferDocIdFromFile(normalizedRelativePath, data.id);
+    const title = data.title || stripNumericPrefix(removeExtension(fileName));
+    return {
+      url: buildUrl(`/docs/${resourceConfig.docsPath}/${resourceId}/${resourceVersion}/${docType}/${docId}`, config),
+      title,
+      summary: data.summary,
+      type: "Resource Doc",
+      collection: docType,
+      id: docId,
+      version: data.version || resourceVersion
+    };
+  }
+  if (segments[0] === "diagrams") {
+    const id = data.id || resourceFolderId;
+    const version = data.version || resourceVersion;
+    return {
+      url: buildUrl(`/diagrams/${id}/${version}`, config),
+      title: data.name || data.title || id,
+      summary: data.summary,
+      type: "Design",
+      collection: "diagrams",
+      id,
+      version
+    };
+  }
+  return null;
+};
+var collectSearchRecords = async ({
+  projectDir,
+  config
+}) => {
+  const files = await glob("**/*.{md,mdx}", {
+    cwd: projectDir,
+    absolute: true,
+    nodir: true,
+    ignore: IGNORED_GLOBS,
+    windowsPathsNoEscape: process.platform === "win32"
+  });
+  const records = await Promise.all(
+    files.map(async (file) => {
+      const raw = await fs.readFile(file, "utf8");
+      const parsed = matter(raw);
+      const relativePath = normalizePath(path.relative(projectDir, file));
+      const baseRecord = await deriveRecordFromPath({
+        projectDir,
+        relativePath,
+        data: parsed.data,
+        config
+      });
+      if (!baseRecord) {
+        return null;
+      }
+      const frontmatterText = valueToSearchText({
+        id: baseRecord.id,
+        title: baseRecord.title,
+        summary: baseRecord.summary,
+        version: baseRecord.version,
+        owners: parsed.data.owners,
+        badges: parsed.data.badges
+      });
+      const content = [frontmatterText, markdownToSearchText(parsed.content)].filter(Boolean).join("\n\n");
+      if (!content.trim()) {
+        return null;
+      }
+      return {
+        ...baseRecord,
+        content
+      };
+    })
+  );
+  const uniqueRecords = /* @__PURE__ */ new Map();
+  for (const record of records) {
+    if (!record) continue;
+    uniqueRecords.set(record.url, record);
+  }
+  return [...uniqueRecords.values()].sort((a, b) => a.url.localeCompare(b.url));
+};
+var getSearchOutputPath = ({
+  outDir,
+  isServer,
+  searchOutputPath
+}) => {
+  if (searchOutputPath) {
+    return searchOutputPath;
+  }
+  return path.join(outDir, isServer ? "client" : "", "pagefind");
+};
+var buildSearchIndex = async ({ projectDir, outDir, config, isServer, searchOutputPath }) => {
+  const records = await collectSearchRecords({ projectDir, config });
+  if (records.length === 0) {
+    throw new Error("No searchable Markdown or MDX content was found.");
+  }
+  const pagefind = await import("pagefind");
+  const { index } = await pagefind.createIndex({
+    keepIndexUrl: false,
+    writePlayground: false
+  });
+  const errors = [];
+  for (const record of records) {
+    const result = await index.addCustomRecord({
+      url: record.url,
+      content: record.content,
+      language: "en",
+      meta: {
+        title: record.title,
+        summary: record.summary || "",
+        type: record.type,
+        collection: record.collection,
+        id: record.id || "",
+        version: record.version || ""
+      },
+      filters: {
+        type: [record.type],
+        collection: [record.collection]
+      }
+    });
+    if (result.errors?.length) {
+      errors.push(...result.errors.map((error) => `${record.url}: ${error.message || error}`));
+    }
+  }
+  const outputPath = getSearchOutputPath({ outDir, isServer, searchOutputPath });
+  await fs.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)));
+  }
+  await index.deleteIndex?.();
+  await pagefind.close?.();
+  if (errors.length > 0) {
+    throw new Error(`Failed to build indexed search:
+${errors.join("\n")}`);
+  }
+  return {
+    records: records.length,
+    outputPath
+  };
+};
+
+export {
+  markdownToSearchText,
+  collectSearchRecords,
+  buildSearchIndex
+};

package/dist/{chunk-R4DR3YAH.js → chunk-HDENGAZL.js}

@@ -1,6 +1,6 @@
 import {
   logger
-} from "./chunk-4SNN54V4.js";
+} from "./chunk-6D65JSOA.js";
 import {
   cleanup,
   getEventCatalogConfigFile

package/dist/{chunk-JEQZWJWP.js → chunk-UJ7DX4SA.js}

@@ -1,10 +1,10 @@
-import {
-  raiseEvent
-} from "./chunk-VJ357XOI.js";
 import {
   countResources,
   serializeCounts
 } from "./chunk-4UVFXLPI.js";
+import {
+  raiseEvent
+} from "./chunk-V22QY5Q3.js";
 import {
   getEventCatalogConfigFile,
   verifyRequiredFieldsAreInCatalogConfigFile

package/dist/{chunk-3KXCGYET.js → chunk-ULZYHF3V.js}

@@ -13,6 +13,10 @@ var isOutputServer = async () => {
   const config = await getEventCatalogConfigFile(process.env.PROJECT_DIR || "");
   return config?.output === "server";
 };
+var isIndexedSearchEnabled = async () => {
+  const config = await getEventCatalogConfigFile(process.env.PROJECT_DIR || "");
+  return config?.search?.type === "indexed";
+};
 var isAuthEnabled = async () => {
   const directory = process.env.PROJECT_DIR || process.cwd();
   const hasAuthConfig = fs.existsSync(join(directory, "eventcatalog.auth.js"));
@@ -22,5 +26,6 @@ var isAuthEnabled = async () => {
 export {
   getProjectOutDir,
   isOutputServer,
+  isIndexedSearchEnabled,
   isAuthEnabled
 };

package/dist/{chunk-VJ357XOI.js → chunk-V22QY5Q3.js}

@@ -1,6 +1,6 @@
 import {
   VERSION
-} from "./chunk-B7C4DHFE.js";
+} from "./chunk-C7JCOHTI.js";
 
 // src/analytics/analytics.js
 import axios from "axios";

package/dist/constants.cjs

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

package/dist/constants.js

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

package/dist/docs/api/02-config.md

@@ -400,6 +400,28 @@ module.exports = {
 | ------ | ---- | ------- | ----------- |
 | `chat.enabled` | `boolean` | `true` | Enables or disables the AI chat feature. Set to `false` to hide the chat UI and prevent chat requests even when all other prerequisites are met. |
 
+### `search` {#search}
+
+<AddedIn version="3.36.0" />
+
+- Type: `object`
+
+Configure the search mode for your catalog.
+
+```js title="eventcatalog.config.js"
+module.exports = {
+  search: {
+    type: 'resource', // default
+  },
+};
+```
+
+| Option | Type | Default | Description |
+| ------ | ---- | ------- | ----------- |
+| `search.type` | `'resource'` \| `'indexed'` | `'resource'` | `'resource'` searches resource metadata only. `'indexed'` enables full-content search powered by [Pagefind](https://pagefind.app/) and builds a static index at build time. |
+
+See the [Search customization](/docs/development/customization/search) guide for details and trade-offs.
+
 ### `changelog` {#changelog}
 
 - Type: `object`

package/dist/docs/api/_category_.json

@@ -9,4 +9,4 @@
     "title": "EventCatalog API Documentation",
     "description": "EventCatalog API Documentation"
   }
-}
+}

package/dist/docs/contributing/_category_.json

@@ -9,4 +9,4 @@
     "title": "EventCatalog Contributing Documentation",
     "description": "EventCatalog Contributing Documentation"
   }
-}
+}

package/dist/docs/development/_category_.json

@@ -9,4 +9,4 @@
     "title": "EventCatalog documentation",
     "description": "EventCatalog documentation. Learn about the fundamentals of EventCatalog."
   }
-}
+}

package/dist/docs/development/ask-your-architecture/02-eventcatalog-assistant/_category_.json

@@ -8,4 +8,4 @@
     "slug": "/development/guides/eventcatalog-assistant",
     "description": "EventCatalog Assistant"
   }
-}
+}

package/dist/docs/development/ask-your-architecture/03-mcp-server/_category_.json

@@ -9,4 +9,4 @@
     "title": "MCP Server",
     "description": "This section contains tutorials for the EventCatalog MCP Server."
   }
-}
+}

package/dist/docs/development/ask-your-architecture/04-skills/_category_.json

@@ -8,4 +8,4 @@
     "slug": "/development/ask-your-architecture/skills",
     "description": "Pre-built AI skills for generating EventCatalog documentation"
   }
-}
+}

package/dist/docs/development/authentication/providers/_category_.json

@@ -8,4 +8,4 @@
     "slug": "/development/authentication/providers",
     "description": "Authentication for EventCatalog"
   }
-}
+}

package/dist/docs/development/bring-your-own-documentation/custom-pages/_category_.json

@@ -8,4 +8,4 @@
     "slug": "guides/bring-your-own-documentation/custom-pages",
     "description": "Add catalog-wide custom documentation pages to your catalog."
   }
-}
+}

package/dist/docs/development/customization/01-customize-landing-page.md

@@ -1,5 +1,5 @@
 ---
-sidebar_position: 1
+sidebar_position: 2
 keywords:
 - EventCatalog landing page
 sidebar_label: Custom landing page

package/dist/docs/development/customization/03-search.md

@@ -0,0 +1,79 @@
+---
+sidebar_position: 1
+keywords:
+  - EventCatalog search
+  - full-content search
+  - indexed search
+  - pagefind
+  - search configuration
+sidebar_label: Search
+title: Search
+description: Configure resource metadata search or opt-in to full-content indexed search
+---
+
+import AddedIn from '@site/src/components/MDX/AddedIn';
+
+<AddedIn version="3.36.0" />
+
+EventCatalog ships with two search modes. The default is a fast metadata search that works with no extra configuration. An opt-in indexed mode adds full-content search powered by [Pagefind](https://pagefind.app/).
+
+## Understand the modes
+
+**Resource search (default)** indexes the metadata of every catalog resource — names, summaries, badges, types, and identifiers. It is fast, requires no build step, and works in both `static` and `server` output modes.
+
+**Indexed search (opt-in)** builds a static index of the full markdown content of your catalog at build time. It can find matches inside the body of a page, changelogs, custom docs, and resource docs — not just the frontmatter fields.
+
+## Enable indexed search
+
+Set `search.type` to `'indexed'` in `eventcatalog.config.js`:
+
+```js title="eventcatalog.config.js"
+module.exports = {
+  search: {
+    type: 'indexed',
+  },
+};
+```
+
+No other changes are required. The index is built automatically as part of `eventcatalog build` and also during `eventcatalog dev`.
+
+## What gets indexed
+
+When indexed search is enabled, the following content is included in the index:
+
+- All catalog resources: events, commands, queries, services, domains, subdomains, channels, containers, data products, entities, and flows
+- Custom docs pages
+- Resource docs
+- Changelogs
+
+## When the index is built
+
+During `eventcatalog build`, the indexer runs after the Astro build and writes the index to `<outDir>/pagefind`.
+
+During `eventcatalog dev`, the index is built on startup and rebuilt automatically whenever any `.md` or `.mdx` file changes (debounced to avoid excessive rebuilds). The first build may take a few seconds depending on the size of your catalog. Subsequent incremental rebuilds are faster.
+
+## Result ranking
+
+Indexed results are ranked by relevance. Matches in the resource title and identifier score highest, followed by matches in the summary and type. Content-body matches score lower than title matches but are still surfaced when no title match is found.
+
+## Auth and the `/pagefind` assets
+
+:::warning Private catalogs
+If your catalog uses authentication (an `eventcatalog.auth.js` file is present), the generated `/pagefind` directory is served as static client-readable assets. Anyone who can load the page can download the index, which contains the full text of all indexed content.
+
+Ensure your deployment platform protects the `/pagefind` path behind the same authentication layer as the rest of your catalog.
+:::
+
+## Keep resource search
+
+To stay on the default resource search, either omit the `search` key entirely or set the type explicitly:
+
+```js title="eventcatalog.config.js"
+module.exports = {
+  search: {
+    type: 'resource', // default, no index built
+  },
+};
+```
+
+Existing catalogs are not affected by this feature — no changes are needed unless you want to opt in.

package/dist/docs/development/customization/custom-components/_category_.json

@@ -8,4 +8,4 @@
     "slug": "/custom-components",
     "description": "A collection of guides to help your understand and build custom components inside your catalog."
   }
-}
+}

package/dist/docs/development/customization/customize-sidebars/_category_.json

@@ -8,4 +8,4 @@
     "slug": "/customize-sidebars",
     "description": "A collection of guides to help you customize the sidebars in your catalog."
   }
-}
+}

package/dist/docs/development/customization/customize-visualizer/_category_.json

@@ -8,4 +8,4 @@
     "slug": "/customize-visualizer",
     "description": "A collection of guides to help you customize the visualizer in your catalog."
   }
-}
+}

package/dist/docs/development/design/_category_.json

@@ -9,4 +9,4 @@
     "title": "Design",
     "description": "This section describes how to use EventCatalog to design workflows and new ideas."
   }
-}
+}

package/dist/docs/development/guides/changelogs/_category_.json

@@ -8,4 +8,4 @@
     "slug": "/changelogs",
     "description": "A collection of guides to help you understand changelogs and how they work with EventCatalog."
   }
-}
+}

package/dist/docs/development/guides/channels/_category_.json

@@ -8,4 +8,4 @@
     "slug": "/channels",
     "description": "A collection of guides to help you understand channels and how they work with EventCatalog."
   }
-}
+}