@brightsideoy/kama 0.1.0-alpha.121 → 0.1.0-alpha.123

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@brightsideoy/kama",
-  "version": "0.1.0-alpha.121",
+  "version": "0.1.0-alpha.123",
   "type": "module",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",

package/templates/astro-starter/src/components/global/Breadcrumb.astro

@@ -2,10 +2,13 @@
 interface Props {
   title: string;
   slug?: string;
+  isHomePage?: boolean;
 }
 
-const { title, slug } = Astro.props;
-const isHome = !slug || slug === "home";
+const { title, slug, isHomePage } = Astro.props;
+
+// 🎯 Detect home page via URL pathname or explicit flag
+const isHome = isHomePage || Astro.url.pathname === "/" || !slug || slug === "";
 ---
 
 <nav class="breadcrumb-nav" aria-label="Breadcrumb">

package/templates/astro-starter/src/components/global/Header.astro

@@ -30,8 +30,17 @@ if (!rawTree || rawTree.length === 0) {
   rawTree = await getTree(getTreeId(), getChannelId(), customFetch);
 }
 
-// Automatically use the configured site name for the text logo
-const siteName = import.meta.env.PUBLIC_SITE_NAME || "KAMA";
+// 🎯 Find the home node in the tree just in case `logoText` isn't set to inherit to subpages
+const homeSlug = import.meta.env.PUBLIC_HOME_SLUG || "home";
+const homeNodeInTree =
+  rawTree?.find((n: any) => n.slug === homeSlug) || rawTree?.[0];
+
+// Automatically use logoText from the current page, fallback to the Home node in the tree, then fallback to ENV
+const siteName =
+  node?.logoText ||
+  homeNodeInTree?.logoText ||
+  import.meta.env.PUBLIC_SITE_NAME ||
+  "KAMA";
 ---
 
 <header class="site-header">

package/templates/astro-starter/src/components/global/NavigationMenu.astro

@@ -11,14 +11,30 @@ const { tree = [] } = Astro.props;
 // 1. Get current path from Astro context
 const currentPath = Astro.url.pathname.replace(/\/$/, "") || "/";
 
+// 🎯 Extract configurable fallback home slug
+const homeSlug = String(import.meta.env.PUBLIC_HOME_SLUG || "home").trim();
+
+// 2. Locate Home Node (either root item, slug matching homeSlug, or path === "/")
 const homeNode = tree.find(
-  (item: TreeNode) => item.slug === "home" || item.path === "/",
+  (item: TreeNode) =>
+    item.slug === homeSlug ||
+    item.slug === "" ||
+    item.path === "/" ||
+    item.path === "",
 );
 
+// 3. Determine top-level navigation items
+// If home node has children (e.g. nested navigation), render its children; otherwise filter out the home node.
 const topLevelNavItems =
   homeNode?.children && homeNode.children.length > 0
     ? homeNode.children
-    : tree.filter((item: TreeNode) => item.slug !== "home");
+    : tree.filter(
+        (item: TreeNode) =>
+          item.slug !== homeSlug &&
+          item.slug !== "" &&
+          item.path !== "/" &&
+          item.path !== "",
+      );
 
 // Normalize path comparison helper
 const normalizePath = (path?: string) => {

package/templates/astro-starter/src/pages/[...slug].astro

@@ -42,18 +42,16 @@ if (isStaticAsset) {
   return new Response(null, { status: 404 });
 }
 
-// 2. PATH RESOLUTION
-const rawSlug = Array.isArray(slug) ? slug.join("/") : slugStr;
-const pathParts = rawSlug.split("/").filter(part => part.trim() !== "");
-const pathToFetch = pathParts.length > 0 ? pathParts.join("/") : "home";
-
-// 3. ENV & WORKER RESOLUTION
+// 2. ENV & WORKER RESOLUTION
 const locals = (Astro.locals as any) || {};
-// SAFELY EXTRACT WORKER ENV USING THE CLOUDFLARE MODULE
 const workerEnv = env || process.env || {};
 const cmsWorker = locals.cfContext?.env?.CMS_WORKER || workerEnv.CMS_WORKER;
 
-// CRITICAL FIX: Flattened to single line to bypass Rolldown parser bug
+// Extract environment configuration & fallback slug
+const envHomeSlug = import.meta.env.PUBLIC_HOME_SLUG;
+const workerHomeSlug = (workerEnv as any).PUBLIC_HOME_SLUG;
+const homeSlug = String(envHomeSlug || workerHomeSlug || "home").trim();
+
 const envApiUrl = import.meta.env.PUBLIC_API_URL;
 const workerApiUrl = workerEnv.PUBLIC_API_URL;
 const baseApiUrl = String(envApiUrl || workerApiUrl || "http://localhost:8787");
@@ -94,19 +92,36 @@ const customFetch = async (input: RequestInfo | URL, init?: RequestInit) => {
 const channelId = getChannelId();
 const treeId = getTreeId();
 
+// 3. PATH RESOLUTION
+const rawSlug = Array.isArray(slug) ? slug.join("/") : slugStr;
+const pathParts = rawSlug.split("/").filter(part => part.trim() !== "");
+
 let pageData: NodeResponse | null = null;
 let navTree: TreeNode[] = [];
+let targetSlug = pathParts.join("/");
 
+// 🎯 FETCH TREE FIRST (to resolve root page if visiting '/')
 try {
-  const [fetchedPage, fetchedTree] = await Promise.all([
-    getNodeByPath(pathToFetch, channelId, isPreview, customFetch),
-    getTree(treeId, channelId, customFetch),
-  ]);
-  pageData = fetchedPage;
-  navTree = fetchedTree;
+  navTree = await getTree(treeId, channelId, customFetch);
+} catch (err) {
+  console.error(`❌ [SSR Error] Failed to fetch tree "${treeId}":`, err);
+}
+
+// 🎯 DYNAMIC HOME SLUG RESOLUTION
+if (!targetSlug) {
+  const rootTreeSlug =
+    navTree && navTree.length > 0
+      ? navTree[0].slug || (navTree[0] as any).key
+      : "";
+  targetSlug = rootTreeSlug || homeSlug;
+}
+
+// 🎯 FETCH NODE DATA
+try {
+  pageData = await getNodeByPath(targetSlug, channelId, isPreview, customFetch);
 } catch (err) {
   console.error(
-    `❌ [SSR Error] Failed to fetch data for path "${pathToFetch}":`,
+    `❌ [SSR Error] Failed to fetch page data for path "${targetSlug}":`,
     err,
   );
 }
@@ -118,9 +133,17 @@ if (!pageData || !pageData.node) {
 const node = pageData.node;
 const content = pageData.content || {};
 
+const rootTreeSlug =
+  navTree && navTree.length > 0
+    ? navTree[0].slug || (navTree[0] as any).key
+    : "";
 const isHomePage =
-  pathToFetch === "home" || node?.path === "/" || pathToFetch === "";
-const normalizedSlug = isHomePage ? "" : pathToFetch;
+  targetSlug === homeSlug ||
+  (rootTreeSlug && targetSlug === rootTreeSlug) ||
+  node?.path === "/" ||
+  pathParts.length === 0;
+
+const normalizedSlug = isHomePage ? "" : targetSlug;
 
 const headerBlocks = content?.header || [];
 const mainBlocks = content?.content || [];

package/templates/astro-starter/src/pages/llms-full.txt.ts

@@ -26,24 +26,32 @@ export const GET: APIRoute = async (context) => {
         return fetch(req);
     };
 
-    const channelId = getChannelId() || import.meta.env.PUBLIC_CHANNEL_ID || "website";
-    const treeId = getTreeId() || import.meta.env.PUBLIC_TREE_ID || "main-navigation";
+    const channelId = getChannelId() || import.meta.env.PUBLIC_CHANNEL_ID || "main-channel";
+    const treeId = getTreeId() || import.meta.env.PUBLIC_TREE_ID || "main-tree";
+
+    // 🎯 Extract configurable fallback home slug
+    const envHomeSlug = import.meta.env.PUBLIC_HOME_SLUG;
+    const workerHomeSlug = cfEnv.PUBLIC_HOME_SLUG || (typeof process !== "undefined" ? process.env?.PUBLIC_HOME_SLUG : undefined);
+    const homeSlug = String(envHomeSlug || workerHomeSlug || "home").trim();
 
     const rawOrigin = import.meta.env.PUBLIC_SITE_URL || context.url.origin;
     const siteOrigin = String(rawOrigin).replace(/\/$/, "");
     const brandName = import.meta.env.PUBLIC_SITE_NAME || "KAMA Starter";
 
     try {
-        // 2. Fetch Home Node (for global context) and Navigation Tree
-        const [homeData, rawNavTree] = await Promise.all([
-            getNodeByPath("home", channelId, false, customFetch).catch(() => null),
-            getTree(treeId, channelId, customFetch).catch(() => []),
-        ]);
-
+        // 2. Fetch Navigation Tree first to determine root nodes
+        const rawNavTree = await getTree(treeId, channelId, customFetch).catch(() => []);
         const navTree = Array.isArray(rawNavTree)
             ? rawNavTree
             : (rawNavTree?.tree || rawNavTree?.items || rawNavTree?.data || []);
 
+        // Determine home page slug (first root node in tree, or fallback home slug)
+        const rootTreeSlug = navTree.length > 0 ? (navTree[0].slug || navTree[0].key || "") : "";
+        const resolvedHomeSlug = rootTreeSlug || homeSlug;
+
+        // Fetch Home Node (for global context)
+        const homeData = await getNodeByPath(resolvedHomeSlug, channelId, false, customFetch).catch(() => null);
+
         const siteSummary = homeData?.node?.abstract || homeData?.node?.summary || "Full Application Documentation Corpus";
 
         // 3. Header section matching llmstxt.org spec
@@ -82,14 +90,16 @@ export const GET: APIRoute = async (context) => {
                 const nodeData = item.node || item;
                 if (!nodeData || nodeData.isHidden) continue;
 
-                const rawPath = nodeData.path || nodeData.slug || "/";
-                const cleanPath = rawPath.startsWith("/") ? rawPath : `/${rawPath}`;
-                const itemUrl = cleanPath === "/" ? siteOrigin : `${siteOrigin}${cleanPath}`;
+                const itemSlug = nodeData.slug || nodeData.path || "";
+                const isRootItem = itemSlug === resolvedHomeSlug || itemSlug === "" || itemSlug === "/";
+                const itemUrl = isRootItem ? siteOrigin : `${siteOrigin}/${itemSlug.replace(/^\//, "")}`;
                 const itemTitle = nodeData.title || nodeData.label || "Untitled Page";
 
+                const fetchSlug = isRootItem ? resolvedHomeSlug : itemSlug.replace(/^\//, "");
+
                 // Fetch node's block contents
                 const pageData = await getNodeByPath(
-                    cleanPath.replace(/^\//, "") || "home",
+                    fetchSlug,
                     channelId,
                     false,
                     customFetch

package/templates/astro-starter/src/pages/llms.txt.ts

@@ -27,25 +27,31 @@ export const GET: APIRoute = async (context) => {
     };
 
     // 2. Load keys from environment or fallback defaults
-    const channelId = getChannelId() || import.meta.env.PUBLIC_CHANNEL_ID || "website";
-    const treeId = getTreeId() || import.meta.env.PUBLIC_TREE_ID || "main-navigation";
+    const channelId = getChannelId() || import.meta.env.PUBLIC_CHANNEL_ID || "main-channel";
+    const treeId = getTreeId() || import.meta.env.PUBLIC_TREE_ID || "main-tree";
+
+    // 🎯 Extract configurable fallback home slug
+    const envHomeSlug = import.meta.env.PUBLIC_HOME_SLUG;
+    const workerHomeSlug = cfEnv.PUBLIC_HOME_SLUG || (typeof process !== "undefined" ? process.env?.PUBLIC_HOME_SLUG : undefined);
+    const homeSlug = String(envHomeSlug || workerHomeSlug || "home").trim();
 
     const rawOrigin = import.meta.env.PUBLIC_SITE_URL || context.url.origin;
     const siteOrigin = String(rawOrigin).replace(/\/$/, "");
     const brandName = import.meta.env.PUBLIC_SITE_NAME || "KAMA Starter";
 
     try {
-        // 3. Parallel fetch for Home Node summary and Navigation Tree
-        const [homeData, rawNavTree] = await Promise.all([
-            getNodeByPath("home", channelId, false, customFetch).catch(() => null),
-            getTree(treeId, channelId, customFetch).catch(() => []),
-        ]);
-
-        // Normalize tree data payload across direct array or wrapped responses
+        // 3. Parallel fetch for Navigation Tree first to resolve root node slug
+        const rawNavTree = await getTree(treeId, channelId, customFetch).catch(() => []);
         const navTree = Array.isArray(rawNavTree)
             ? rawNavTree
             : (rawNavTree?.tree || rawNavTree?.items || rawNavTree?.data || []);
 
+        const rootTreeSlug = navTree.length > 0 ? (navTree[0].slug || navTree[0].key || "") : "";
+        const resolvedHomeSlug = rootTreeSlug || homeSlug;
+
+        // Fetch Home Node summary
+        const homeData = await getNodeByPath(resolvedHomeSlug, channelId, false, customFetch).catch(() => null);
+
         const siteSummary = homeData?.node?.abstract || homeData?.node?.summary || "Global Content Delivery at the Edge";
 
         // 4. Build standard-compliant llms.txt Markdown
@@ -63,9 +69,9 @@ export const GET: APIRoute = async (context) => {
                 const nodeData = item.node || item;
                 if (!nodeData || nodeData.isHidden) continue;
 
-                const rawPath = nodeData.path || nodeData.slug || "/";
-                const cleanPath = rawPath.startsWith("/") ? rawPath : `/${rawPath}`;
-                const itemUrl = cleanPath === "/" ? siteOrigin : `${siteOrigin}${cleanPath}`;
+                const itemSlug = nodeData.slug || nodeData.path || "";
+                const isRootItem = itemSlug === resolvedHomeSlug || itemSlug === "" || itemSlug === "/";
+                const itemUrl = isRootItem ? siteOrigin : `${siteOrigin}/${itemSlug.replace(/^\//, "")}`;
 
                 const itemTitle = nodeData.title || nodeData.label || nodeData.menuTitle || "Untitled";
                 const abstract = nodeData.abstract || nodeData.summary || nodeData.description;