@eventcatalog/core 2.12.1 → 2.12.2

package/CHANGELOG.md

@@ -1,5 +1,11 @@
 # @eventcatalog/core
 
+## 2.12.2
+
+### Patch Changes
+
+- 93e224c: fix(core): custom defined landing page for docs now render on docs tab
+
 ## 2.12.1
 
 ### Patch Changes

package/README.md

@@ -133,6 +133,15 @@ Thank you to our project  sponsors.
 
 <hr />
 
+<div align="center">
+  <img alt="oso" src="./images/sponsors/oso-logo-green.png" width="30%" />
+  <p style="margin: 0; padding: 0;">Delivering Apache Kafka professional services to your business
+</p>
+  <a href="https://oso.sh/?utm_source=eventcatalog&utm_medium=web&utm_campaign=sponsorship" target="_blank" >Learn more</a>
+</div>
+
+<hr />
+
 _Sponsors help make EventCatalog sustainable, want to help the project? Get in touch! Or [visit our sponsor page](https://www.eventcatalog.dev/support)._
 
 # Enterprise support

package/package.json

@@ -6,7 +6,7 @@
     "url": "https://github.com/event-catalog/eventcatalog.git"
   },
   "type": "module",
-  "version": "2.12.1",
+  "version": "2.12.2",
   "publishConfig": {
     "access": "public"
   },

package/src/layouts/VerticalSideBarLayout.astro

@@ -16,10 +16,11 @@ import { getServices } from '@utils/services/services';
 import { getFlows } from '@utils/flows/flows';
 import { getTeams } from '@utils/teams';
 import { getUsers } from '@utils/users';
-import config, { type CatalogConfig } from '@eventcatalog';
+import { isCollectionVisibleInCatalog } from '@eventcatalog';
 import { buildUrl } from '@utils/url-builder';
 import { getQueries } from '@utils/queries';
 import CatalogResourcesSideBar from '@components/SideBars/CatalogResourcesSideBar';
+import { hasLandingPageForDocs } from '@utils/pages';
 
 const events = await getEvents({ getAllVersions: false });
 const commands = await getCommands({ getAllVersions: false });
@@ -37,12 +38,23 @@ const allData = [...domains, ...services, ...messages, ...flows, ...teams, ...us
 
 const currentPath = Astro.url.pathname;
 
+const catalogHasDefaultLandingPageForDocs = await hasLandingPageForDocs();
+
 const getDefaultUrl = (route: string, defaultValue: string) => {
-  if (domains.length > 0) return buildUrl(`/${route}/domains/${domains[0].data.id}/${domains[0].data.latestVersion}`);
-  if (services.length > 0) return buildUrl(`/${route}/services/${services[0].data.id}/${services[0].data.latestVersion}`);
-  if (messages.length > 0)
-    return buildUrl(`/${route}/${messages[0].collection}/${messages[0].data.id}/${messages[0].data.latestVersion}`);
-  if (flows.length > 0) return buildUrl(`/${route}/flows/${flows[0].data.id}/${flows[0].data.latestVersion}`);
+  const collections = [
+    { data: domains, key: 'domains' },
+    { data: services, key: 'services' },
+    { data: messages, key: 'messages' },
+    { data: flows, key: 'flows' },
+  ];
+
+  for (const { data, key } of collections) {
+    if (data.length > 0 && isCollectionVisibleInCatalog(key)) {
+      const item = data[0];
+      return buildUrl(`/${route}/${key}/${item.data.id}/${item.data.latestVersion}`);
+    }
+  }
+
   return buildUrl(defaultValue);
 };
 
@@ -59,7 +71,7 @@ const navigationItems = [
     id: '/docs',
     label: 'Documentation',
     icon: BookOpenText,
-    href: getDefaultUrl('docs', '/docs'),
+    href: catalogHasDefaultLandingPageForDocs ? buildUrl('/docs') : getDefaultUrl('docs', '/docs'),
     current: currentPath.includes('/docs'),
     sidebar: true,
   },
@@ -81,31 +93,6 @@ const navigationItems = [
   },
 ];
 
-const eventCatalogConfig = config as CatalogConfig;
-
-const {
-  services: servicesConfig,
-  domains: domainsConfig,
-  messages: messagesConfig,
-  flows: flowsConfig,
-  teams: teamsConfig,
-  users: usersConfig,
-} = eventCatalogConfig?.docs?.sidebar || {};
-
-const getConfigValue = (obj: any, key: string, defaultValue: any) => {
-  return obj?.[key] ?? defaultValue;
-};
-
-const visibleCollections: { [key: string]: boolean } = {
-  events: getConfigValue(messagesConfig, 'visible', true),
-  commands: getConfigValue(messagesConfig, 'visible', true),
-  domains: getConfigValue(domainsConfig, 'visible', true),
-  flows: getConfigValue(flowsConfig, 'visible', true),
-  services: getConfigValue(servicesConfig, 'visible', true),
-  teams: getConfigValue(teamsConfig, 'visible', true),
-  users: getConfigValue(usersConfig, 'visible', true),
-};
-
 const sideNav = allData.reduce((acc, item) => {
   const title = item.collection;
   const group = acc[title] || [];
@@ -120,7 +107,7 @@ const sideNav = allData.reduce((acc, item) => {
     label: item.data.name,
     version: item.collection === 'teams' || item.collection === 'users' ? null : item.data.version,
     // items: item.collection === 'users' ? [] : item.headings,
-    visible: visibleCollections[item.collection],
+    visible: isCollectionVisibleInCatalog(item.collection),
     // @ts-ignore
     href: item.data.version
       ? // @ts-ignore

package/src/pages/docs/index.astro

@@ -17,11 +17,15 @@ if (page) {
 {
   CustomContent && (
     <VerticalSideBarLayout title="EventCatalog">
-      <main class="py-8 px-8">
-        <div class="prose prose-md w-full !max-w-none">
-          <CustomContent components={components} />
+      <main class="flex sm:px-8 docs-layout h-full">
+        <div class="flex docs-layout w-full">
+          <div class="w-full lg:mr-2 pr-8 overflow-y-auto py-8">
+            <div class="prose prose-md w-full !max-w-none">
+              <CustomContent components={components} />
+            </div>
+            <Footer />
+          </div>
         </div>
-        <Footer />
       </main>
     </VerticalSideBarLayout>
   )

package/src/utils/config/catalog.ts

@@ -18,4 +18,19 @@ export type CatalogConfig = {
   };
 };
 
+const getConfigValue = (obj: any, key: string, defaultValue: any) => {
+  return obj?.[key] ?? defaultValue;
+};
+
+export const isCollectionVisibleInCatalog = (collection: string) => {
+  const sidebarConfig = config?.default?.docs?.sidebar || {};
+  const collections = ['events', 'commands', 'queries', 'domains', 'flows', 'services', 'teams', 'users'];
+
+  if (!collections.includes(collection)) return false;
+
+  const collectionConfig =
+    sidebarConfig[collection === 'events' || collection === 'commands' || collection === 'queries' ? 'messages' : collection];
+  return getConfigValue(collectionConfig, 'visible', true);
+};
+
 export default config.default;

package/src/utils/pages.ts

@@ -13,3 +13,8 @@ export const getIndexPage = async (): Promise<Page> => {
   const pages = await getCollection('pages');
   return pages.find((page) => page.slug === 'index')!;
 };
+
+export const hasLandingPageForDocs = async (): Promise<boolean> => {
+  const pages = await getCollection('pages');
+  return pages.some((page) => page.slug === 'index')!;
+};