@aravindc26/velu 0.13.3 → 0.13.5

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@aravindc26/velu",
-  "version": "0.13.3",
+  "version": "0.13.5",
   "description": "A modern documentation site generator powered by Markdown and JSON configuration",
   "type": "module",
   "license": "MIT",

package/src/engine/app/_preview/[sessionId]/[...slug]/layout.tsx

@@ -1,3 +1,5 @@
+export const dynamic = 'force-dynamic';
+
 import { createElement, type ReactNode } from 'react';
 import { loadSessionConfigSource } from '@/lib/preview-config';
 import {

package/src/engine/app/_preview/[sessionId]/[...slug]/page.tsx

@@ -23,6 +23,9 @@ import { OpenApiTocSync } from '@/components/openapi-toc-sync';
 import { TocExamples } from '@/components/toc-examples';
 import { VeluIcon } from '@/components/icon';
 
+// Disable Next.js route caching — content changes on every sync
+export const dynamic = 'force-dynamic';
+
 interface PageProps {
   params: Promise<{ sessionId: string; slug: string[] }>;
 }
@@ -138,10 +141,15 @@ function prefixMdxComponentLinks(
 export default async function PreviewPage({ params }: PageProps) {
   const { sessionId, slug } = await params;
 
+  console.log(`[PREVIEW:page] START session=${sessionId} slug=${slug.join('/')}`);
+
   const src = await getSessionSource(sessionId);
   const page = src.getPage(slug);
 
-  if (!page) notFound();
+  if (!page) {
+    console.log(`[PREVIEW:page] Page NOT FOUND for slug=${slug.join('/')}`);
+    notFound();
+  }
 
   const pageDataRecord = page.data as unknown as Record<string, unknown>;
 
@@ -151,17 +159,22 @@ export default async function PreviewPage({ params }: PageProps) {
   let pageToc: any;
 
   if (typeof loadFn === 'function') {
-    // Dynamic/async entry — compile MDX on demand
+    console.log(`[PREVIEW:page] Calling load() for slug=${slug.join('/')}`);
     const loaded = await loadFn();
     MDX = loaded.body;
     pageToc = loaded.toc;
+    console.log(`[PREVIEW:page] load() returned MDX=${typeof MDX} toc=${typeof pageToc}`);
   } else {
     // Fallback: pre-compiled entry (shouldn't happen in preview mode, but safe)
+    console.log(`[PREVIEW:page] No load() — using pre-compiled body for slug=${slug.join('/')}`);
     MDX = pageDataRecord.body as any;
     pageToc = pageDataRecord.toc as any;
   }
 
-  if (typeof MDX !== 'function') notFound();
+  if (typeof MDX !== 'function') {
+    console.log(`[PREVIEW:page] MDX is not a function (type=${typeof MDX}), returning 404`);
+    notFound();
+  }
 
   const configSource = loadSessionConfigSource(sessionId);
   const footerSocials = configSource ? getFooterSocials(configSource) : [];
@@ -173,6 +186,7 @@ export default async function PreviewPage({ params }: PageProps) {
   if (pageInfo?.fullPath) {
     try {
       effectiveMarkdown = readFileSync(pageInfo.fullPath, 'utf-8');
+      console.log(`[PREVIEW:page] Read markdown from ${pageInfo.fullPath} (${effectiveMarkdown.length} chars, first 120: ${JSON.stringify(effectiveMarkdown.slice(0, 120))})`);
     } catch { /* file may not exist */ }
   }
 

package/src/engine/app/_preview/[sessionId]/page.tsx

@@ -1,3 +1,5 @@
+export const dynamic = 'force-dynamic';
+
 import { redirect } from 'next/navigation';
 import { getSessionPageTree } from '@/lib/preview-source';
 

package/src/engine/app/_preview/api/sessions/[sessionId]/init/route.ts

@@ -11,12 +11,16 @@ export async function POST(
 
   const { sessionId } = await params;
 
+  console.log(`[PREVIEW:init] START session=${sessionId}`);
+
   try {
     const result = generateSessionContent(sessionId);
+    console.log(`[PREVIEW:init] generateSessionContent result:`, JSON.stringify(result));
 
     // Invalidate the cached dynamic source so the next page request
     // re-scans the content directory and picks up the new files.
     invalidateSessionSource(sessionId);
+    console.log(`[PREVIEW:init] DONE session=${sessionId}`);
 
     return Response.json({
       status: 'ready',
@@ -26,7 +30,7 @@ export async function POST(
     });
   } catch (error) {
     const message = error instanceof Error ? error.message : 'Unknown error';
-    console.error(`[PREVIEW] Init failed for session ${sessionId}:`, message);
+    console.error(`[PREVIEW:init] FAILED session=${sessionId}:`, message);
     return Response.json(
       { status: 'error', error: message },
       { status: 500 },

package/src/engine/app/_preview/api/sessions/[sessionId]/sync/route.ts

@@ -12,6 +12,8 @@ export async function POST(
   const { sessionId } = await params;
   const file = request.nextUrl.searchParams.get('file');
 
+  console.log(`[PREVIEW:sync] START session=${sessionId} file=${file}`);
+
   if (!file) {
     return Response.json(
       { error: 'Missing "file" query parameter' },
@@ -21,9 +23,11 @@ export async function POST(
 
   try {
     const result = syncSessionFile(sessionId, file);
+    console.log(`[PREVIEW:sync] syncSessionFile result:`, JSON.stringify(result));
 
     // Invalidate cached source so next page request re-scans content
     invalidateSessionSource(sessionId);
+    console.log(`[PREVIEW:sync] DONE session=${sessionId} file=${file}`);
 
     return Response.json({
       status: 'synced',
@@ -32,7 +36,7 @@ export async function POST(
     });
   } catch (error) {
     const message = error instanceof Error ? error.message : 'Unknown error';
-    console.error(`[PREVIEW] Sync failed for session ${sessionId}, file ${file}:`, message);
+    console.error(`[PREVIEW:sync] FAILED session=${sessionId} file=${file}:`, message);
     return Response.json(
       { status: 'error', error: message },
       { status: 500 },

package/src/engine/lib/preview-content.ts

@@ -755,7 +755,10 @@ export function syncSessionFile(
   const workspaceDir = join(WORKSPACE_DIR, sessionId);
   const outputDir = join(PREVIEW_CONTENT_DIR, sessionId);
 
+  console.log(`[PREVIEW:syncFile] session=${sessionId} file=${filePath} workspace=${workspaceDir} output=${outputDir}`);
+
   if (filePath === PRIMARY_CONFIG_NAME || filePath === LEGACY_CONFIG_NAME) {
+    console.log(`[PREVIEW:syncFile] Config file changed — regenerating all content`);
     generateSessionContent(sessionId);
     return { synced: true };
   }
@@ -777,9 +780,13 @@ export function syncSessionFile(
     srcPath = join(workspaceDir, `${stripped}.md`);
   }
   if (!existsSync(srcPath)) {
+    console.log(`[PREVIEW:syncFile] Source file NOT FOUND at any candidate path for ${filePath}`);
     return { synced: false };
   }
 
+  const srcContent = readFileSync(srcPath, 'utf-8');
+  console.log(`[PREVIEW:syncFile] Source file: ${srcPath} (${srcContent.length} chars, first 120: ${JSON.stringify(srcContent.slice(0, 120))})`);
+
   try {
     const { config } = loadConfig(workspaceDir);
     const artifacts = buildArtifacts(config, workspaceDir);
@@ -789,15 +796,22 @@ export function syncSessionFile(
 
     if (mapping) {
       const destPath = join(outputDir, `${mapping.dest}.mdx`);
+      console.log(`[PREVIEW:syncFile] Mapped: ${stripped} -> ${mapping.dest}, writing to ${destPath}`);
       processPage(srcPath, destPath, stripped, variables, sessionId);
+      const written = readFileSync(destPath, 'utf-8');
+      console.log(`[PREVIEW:syncFile] Written dest (${written.length} chars, first 120: ${JSON.stringify(written.slice(0, 120))})`);
       return { synced: true };
     }
-  } catch {
-    // Fall through to direct copy
+    console.log(`[PREVIEW:syncFile] No mapping found for ${stripped} in pageMap (${artifacts.pageMap.length} entries)`);
+  } catch (err) {
+    console.log(`[PREVIEW:syncFile] Mapping lookup failed, falling through to direct copy:`, err instanceof Error ? err.message : err);
   }
 
   const destPath = join(outputDir, `${stripped}.mdx`);
+  console.log(`[PREVIEW:syncFile] Direct copy: ${srcPath} -> ${destPath}`);
   processPage(srcPath, destPath, stripped, variables, sessionId);
+  const written = readFileSync(destPath, 'utf-8');
+  console.log(`[PREVIEW:syncFile] Written dest (${written.length} chars, first 120: ${JSON.stringify(written.slice(0, 120))})`);
   return { synced: true };
 }
 

package/src/engine/lib/preview-source.ts

@@ -9,7 +9,7 @@
  * Used only in preview mode (PREVIEW_MODE=true) — production builds still use
  * the standard `source.ts` with build-time collections.
  */
-import { existsSync, readFileSync, readdirSync } from 'node:fs';
+import { existsSync, readFileSync, readdirSync, statSync } from 'node:fs';
 import { join, relative } from 'node:path';
 import { loader } from 'fumadocs-core/source';
 import { dynamic } from 'fumadocs-mdx/runtime/dynamic';
@@ -24,6 +24,11 @@ import * as sourceConfigExports from '../source.config';
 
 const PREVIEW_CONTENT_DIR = process.env.PREVIEW_CONTENT_DIR || './content';
 
+function log(tag: string, msg: string, data?: Record<string, unknown>) {
+  const payload = data ? ' ' + JSON.stringify(data) : '';
+  console.log(`[PREVIEW:${tag}] ${msg}${payload}`);
+}
+
 // ── Cache ──────────────────────────────────────────────────────────────────
 
 // eslint-disable-next-line @typescript-eslint/no-explicit-any
@@ -37,6 +42,7 @@ async function getDynamic() {
   if (dynamicInstance) return dynamicInstance;
   if (dynamicInitPromise) return dynamicInitPromise;
 
+  log('dynamic', 'Initializing new dynamic() instance');
   dynamicInitPromise = dynamic(
     sourceConfigExports,
     {
@@ -47,6 +53,7 @@ async function getDynamic() {
   ).then((inst) => {
     dynamicInstance = inst;
     dynamicInitPromise = null;
+    log('dynamic', 'dynamic() instance ready');
     return inst;
   });
 
@@ -146,11 +153,16 @@ function scanContentDir(sessionDir: string): {
  */
 export async function getSessionSource(sessionId: string) {
   const cached = sourceCache.get(sessionId);
-  if (cached) return cached.source;
+  if (cached) {
+    const age = Date.now() - cached.createdAt;
+    log('source', `Cache HIT for session ${sessionId}`, { ageMs: age });
+    return cached.source;
+  }
+  log('source', `Cache MISS for session ${sessionId}`);
 
   const sessionDir = join(PREVIEW_CONTENT_DIR, sessionId);
   if (!existsSync(sessionDir)) {
-    // Return an empty source if no content yet
+    log('source', `Session dir does not exist: ${sessionDir}`);
     const emptySource = loader({
       baseUrl: '/',
       source: { files: [] },
@@ -161,6 +173,20 @@ export async function getSessionSource(sessionId: string) {
   const dyn = await getDynamic();
   const { entries, metaFiles } = scanContentDir(sessionDir);
 
+  log('source', `Scanned ${sessionDir}`, {
+    entryCount: entries.length,
+    metaFileCount: Object.keys(metaFiles).length,
+    files: entries.map((e) => {
+      const stat = statSync(e.info.fullPath, { throwIfNoEntry: false });
+      return {
+        path: e.info.path,
+        title: e.data.title,
+        sizeBytes: stat?.size,
+        mtimeMs: stat?.mtimeMs,
+      };
+    }),
+  });
+
   const collection = await dyn.docs('docs', sessionDir, metaFiles, entries);
   const fumadocsSource = collection.toFumadocsSource();
 
@@ -188,6 +214,9 @@ export async function getSessionSource(sessionId: string) {
   });
 
   sourceCache.set(sessionId, { source: src, createdAt: Date.now() });
+  log('source', `Built and cached source for session ${sessionId}`, {
+    pageCount: src.getPages().length,
+  });
   return src;
 }
 
@@ -196,7 +225,9 @@ export async function getSessionSource(sessionId: string) {
  * Call after content generation or sync so the next request re-scans.
  */
 export function invalidateSessionSource(sessionId: string): void {
+  const had = sourceCache.has(sessionId);
   sourceCache.delete(sessionId);
+  log('invalidate', `session=${sessionId} hadCache=${had} remainingKeys=[${[...sourceCache.keys()].join(',')}]`);
 }
 
 /**