jamdesk 1.1.70 → 1.1.72

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "jamdesk",
-  "version": "1.1.70",
+  "version": "1.1.72",
   "description": "CLI for Jamdesk — build, preview, and deploy documentation sites from MDX. Dev server with hot reload, 50+ components, OpenAPI support, AI search, and Mintlify migration",
   "keywords": [
     "jamdesk",
@@ -115,7 +115,7 @@
     "nspell": "^2.1.5",
     "open": "^11.0.0",
     "ora": "^9.4.0",
-    "tar": "^7.5.9"
+    "tar": "^7.5.14"
   },
   "devDependencies": {
     "@mdx-js/mdx": "^3.1.1",

package/vendored/app/(jd-system)/jd-inactive/BrandedInactive.tsx

@@ -0,0 +1,118 @@
+import React from "react";
+
+export interface BrandedInactiveProps {
+  projectName?: string;
+  logoUrl?: string;
+  hasCustomDomain?: boolean;
+}
+
+export function BrandedInactive({
+  projectName, logoUrl, hasCustomDomain = false,
+}: BrandedInactiveProps): React.ReactElement {
+  const showBrandMark = Boolean(logoUrl || projectName);
+  return (
+    <div style={styles.shell}>
+      <main style={styles.main}>
+        <div style={styles.card}>
+          {showBrandMark ? (
+            <div style={styles.brandMark}>
+              {logoUrl ? (
+                <img
+                  src={logoUrl}
+                  alt={projectName ?? ""}
+                  width={120}
+                  height={32}
+                  style={styles.logo}
+                />
+              ) : null}
+              {projectName ? (
+                <span style={styles.projectName}>{projectName}</span>
+              ) : null}
+            </div>
+          ) : null}
+          <h1 style={styles.heading}>This site is currently paused</h1>
+          <p style={styles.body}>
+            The owner needs to reactivate their subscription to bring
+            this documentation back online.
+          </p>
+          {hasCustomDomain ? (
+            <p style={styles.bodySubtle}>
+              If you&rsquo;re the owner, sign in to restore access.
+            </p>
+          ) : null}
+        </div>
+      </main>
+      <footer style={styles.footer}>
+        <a href="https://jamdesk.com" style={styles.poweredBy}>
+          Powered by{" "}
+          <strong style={styles.brand} translate="no">Jamdesk</strong>
+        </a>
+      </footer>
+    </div>
+  );
+}
+
+const styles: Record<string, React.CSSProperties> = {
+  shell: {
+    minHeight: "100vh",
+    display: "grid",
+    gridTemplateRows: "1fr auto",
+    background:
+      "radial-gradient(ellipse 80% 50% at 50% 30%, " +
+      "rgba(255,54,33,0.07), transparent 70%), #0a0a0d",
+    color: "#e8e8ee",
+    fontFamily:
+      "'Inter',-apple-system,BlinkMacSystemFont,'Segoe UI',sans-serif",
+    padding:
+      "env(safe-area-inset-top) env(safe-area-inset-right) " +
+      "env(safe-area-inset-bottom) env(safe-area-inset-left)",
+  },
+  main: {
+    display: "flex", flexDirection: "column",
+    alignItems: "center", justifyContent: "center",
+    padding: "2rem", textAlign: "center",
+  },
+  card: {maxWidth: "32rem", width: "100%"},
+  brandMark: {
+    display: "inline-flex", alignItems: "center",
+    gap: "0.75rem", marginBottom: "1.25rem",
+  },
+  logo: {
+    height: "auto", maxHeight: "2rem", maxWidth: "8rem",
+    display: "block", opacity: 0.95,
+  },
+  projectName: {
+    fontSize: "clamp(1.75rem, 4.5vw, 2.25rem)",
+    fontWeight: 600, color: "#e8e8ee",
+    lineHeight: 1.2,
+    letterSpacing: "-0.01em",
+    textWrap: "balance",
+  },
+  heading: {
+    fontSize: "1rem",
+    fontWeight: 400, lineHeight: 1.6,
+    margin: "0 0 0.5rem",
+    color: "#e8e8ee",
+    textWrap: "balance",
+  },
+  body: {
+    fontSize: "1rem", color: "#b4b4bf",
+    lineHeight: 1.6, margin: "0 0 0.75rem",
+    textWrap: "pretty",
+  },
+  bodySubtle: {
+    fontSize: "0.875rem", color: "#8a8a96",
+    margin: 0, textWrap: "pretty",
+  },
+  footer: {
+    display: "flex", justifyContent: "center",
+    padding: "1.5rem",
+  },
+  poweredBy: {
+    color: "#6a6a76",
+    fontSize: "0.8125rem",
+    textDecoration: "none",
+    letterSpacing: "0.02em",
+  },
+  brand: {color: "#ff3621", fontWeight: 600},
+};

package/vendored/app/(jd-system)/jd-inactive/layout.tsx

@@ -0,0 +1,12 @@
+import type {Metadata} from "next";
+
+// Root layout's `x-jd-layout: placeholder` branch owns the shell.
+export const metadata: Metadata = {
+  title: "Docs Site Unavailable",
+};
+
+export default function InactiveLayout(
+  {children}: {children: React.ReactNode},
+) {
+  return children;
+}

package/vendored/app/(jd-system)/jd-inactive/page.tsx

@@ -0,0 +1,40 @@
+import {headers} from "next/headers";
+import {notFound} from "next/navigation";
+import {isUrlSafe} from "@/lib/url-safety";
+import {BrandedInactive} from "./BrandedInactive";
+
+// Read project data from middleware-set headers per-request. We can't
+// use force-static because the proxy sets different headers for each
+// paused project (name, logo, custom-domain flag). The response is
+// still trivially cacheable at the edge with a short TTL.
+export const dynamic = "force-dynamic";
+
+export default async function InactivePage() {
+  const h = await headers();
+  // Direct hits to /jd-inactive (without a proxy rewrite) must 404 rather
+  // than render the generic placeholder. Otherwise anyone could probe
+  // <slug>.jamdesk.app/jd-inactive and learn whether the slug is hosted
+  // here, plus see the "site paused" copy on slugs that are actually
+  // healthy. The proxy always sets x-jd-layout=placeholder when it
+  // rewrites for the inactive flag — its absence means we got here from
+  // the user typing the URL.
+  if (h.get("x-jd-layout") !== "placeholder") {
+    notFound();
+  }
+  const projectName = h.get("x-jd-project-name") ?? undefined;
+  // Logo URL is customer-supplied (flows from Redis through middleware
+  // headers). isUrlSafe blocks data:/javascript:, plus SSRF vectors
+  // (private IPs, encoded IPv4 bypasses, IPv6 loopback) — same threat
+  // model as the API-playground proxy uses. Mirror in proxy/lib/
+  // inactive-html.ts via sanitizeLogoUrl.
+  const rawLogo = h.get("x-jd-project-logo");
+  const logoUrl = rawLogo && isUrlSafe(rawLogo) ? rawLogo : undefined;
+  const hasCustomDomain = h.get("x-jd-custom-domain") === "1";
+  return (
+    <BrandedInactive
+      projectName={projectName}
+      logoUrl={logoUrl}
+      hasCustomDomain={hasCustomDomain}
+    />
+  );
+}

package/vendored/app/(unlock)/jd/unlock/page.tsx

@@ -2,6 +2,7 @@ import { headers } from 'next/headers';
 import { getDocsConfig } from '@/lib/docs-isr';
 import { normalizeLogo } from '@/lib/docs-types';
 import { sanitizeFrom } from '@/lib/sanitize-from';
+import { getBrandingUrl } from '@/lib/branding-url';
 import UnlockForm from './UnlockForm';
 
 interface UnlockPageProps {
@@ -29,14 +30,19 @@ export default async function UnlockPage({ searchParams }: UnlockPageProps) {
   const from = sanitizeFrom(rawFrom ?? null);
   const showError = params.error === '1';
 
+  const showBranding = process.env.NEXT_PUBLIC_SHOW_BRANDING !== 'false';
+  const brandingUrl = getBrandingUrl(slug);
+
   return (
     <main
       style={{
         minHeight: '100vh',
         display: 'flex',
+        flexDirection: 'column',
         alignItems: 'center',
         justifyContent: 'center',
         padding: '24px 16px',
+        gap: 24,
       }}
     >
       <section
@@ -152,6 +158,32 @@ export default async function UnlockPage({ searchParams }: UnlockPageProps) {
           </p>
         )}
       </section>
+
+      {showBranding && (
+        <a
+          href={brandingUrl}
+          target="_blank"
+          rel="noopener noreferrer"
+          style={{
+            display: 'inline-flex',
+            alignItems: 'center',
+            gap: 6,
+            fontSize: 13,
+            color: '#9ca3af',
+            textDecoration: 'none',
+          }}
+        >
+          Powered by
+          {/* eslint-disable-next-line @next/next/no-img-element */}
+          <img
+            src="/_jd/branding/jamdesk-wordmark.svg"
+            alt="Jamdesk"
+            width={58}
+            height={15}
+            style={{ display: 'inline-block', verticalAlign: 'middle' }}
+          />
+        </a>
+      )}
     </main>
   );
 }

package/vendored/app/[[...slug]]/page.tsx

@@ -25,54 +25,102 @@ interface PageProps {
   }>;
 }
 
-function getAllDocPaths(): string[] {
+// Mirror of the CLI's detector regex in cli/src/lib/relative-mdx-imports.ts.
+// Duplicated intentionally — build-service uses bundler module resolution
+// and shouldn't reach into cli/src/. Keep the regex itself in sync with
+// that file. Two intentional simplifications vs the CLI version:
+//   - no `g` flag (boolean test, not iteration)
+//   - fence stripping replaces matches with empty string instead of
+//     blank lines of equal count — line numbers don't matter here, only
+//     a yes/no skip decision (the CLI preserves them for warning text).
+const PARENT_RELATIVE_MDX_IMPORT_RE =
+  /^[ \t]*import\s+(?:type\s+)?[\w$*{}, \n\r]+\s+from\s+["']\.{1,2}\/[^"']+\.mdx["']\s*;?/m;
+
+const FENCED_CODE_BLOCK_RE =
+  /^( *)(```+|~~~+)[^\n]*\n([\s\S]*?)\n\1\2\s*$/gm;
+
+export function pageHasRelativeMdxImport(filePath: string): boolean {
+  try {
+    // Read the full file — MDX imports can appear at any top-level position
+    // (after a long prose intro or table of contents), and a slice was
+    // missing real imports past byte ~8192 in 70-94 KB customer pages.
+    const content = fs.readFileSync(filePath, 'utf-8');
+    // Strip fenced code blocks so documentation examples (e.g.
+    // ```mdx\nimport X from "../snippets/foo.mdx";\n```) don't false-trigger.
+    return PARENT_RELATIVE_MDX_IMPORT_RE.test(content.replace(FENCED_CODE_BLOCK_RE, ''));
+  } catch {
+    return false;
+  }
+}
+
+interface CollectedPaths {
+  supported: string[];
+  skipped: string[];
+}
+
+function getAllDocPaths(): CollectedPaths {
   const contentDir = getContentDir();
-  const paths: string[] = [];
+  const supported: string[] = [];
+  const skipped: string[] = [];
 
   function traverseDir(dir: string, basePath: string = '') {
     if (!fs.existsSync(dir)) return;
     const files = fs.readdirSync(dir);
     for (const file of files) {
-      // Skip dotfiles (.claude, .git, etc.)
       if (file.startsWith('.')) continue;
       const filePath = path.join(dir, file);
       let stat;
       try {
         stat = fs.statSync(filePath);
       } catch {
-        // Broken symlink or inaccessible — skip
         continue;
       }
       if (stat.isDirectory()) {
         traverseDir(filePath, path.join(basePath, file));
       } else if (file.endsWith('.mdx')) {
         const slug = path.join(basePath, file.replace(/\.mdx$/, ''));
-        paths.push(slug);
+        if (pageHasRelativeMdxImport(filePath)) {
+          skipped.push(slug);
+        } else {
+          supported.push(slug);
+        }
       }
     }
   }
 
   traverseDir(contentDir);
-  return paths;
+  return { supported, skipped };
 }
 
+// In `jamdesk dev`, Next.js calls generateStaticParams during initial
+// compile AND for each lazily-compiled route (every page click). Without
+// a guard the same multi-line warning floods the dev console after every
+// navigation. Cache the prior skipped set and re-log only when it changes
+// — that way a user who fixes one import still sees the list shrink, but
+// repeated calls with no change stay quiet.
+let lastSkippedKey: string | null = null;
+
 export async function generateStaticParams() {
   // ISR: pages generated on-demand, no build-time pre-render.
   if (isIsrMode()) return [];
 
-  const paths = getAllDocPaths();
-  // next-mdx-remote can't compile relative MDX imports — skip those tests.
-  const unsupportedPatterns = ['deep-relative-test', 'relative-snippets-test'];
+  const { supported, skipped } = getAllDocPaths();
 
-  const supportedPaths = paths.filter(p => {
-    const skip = unsupportedPatterns.some(pattern => p.includes(pattern));
-    if (skip) console.log(`[Build] Skipping page with unsupported relative imports: ${p}`);
-    return !skip;
-  });
+  const skippedKey = skipped.length === 0 ? '' : skipped.slice().sort().join('\n');
+  if (skippedKey !== lastSkippedKey) {
+    lastSkippedKey = skippedKey;
+    if (skipped.length > 0) {
+      console.log(`[Build] Skipped ${skipped.length} page(s) with parent-relative MDX imports:`);
+      for (const slug of skipped) {
+        console.log(`  - ${slug}`);
+      }
+      console.log('  Run "jamdesk migrate" to auto-fix moveable imports, or "jamdesk validate" for per-import detail.');
+    }
+  }
 
   return [
     { slug: [] },
-    ...supportedPaths.map((p) => ({ slug: p.split('/') })),
+    ...supported.map((p) => ({ slug: p.split('/') })),
   ];
 }
 

package/vendored/app/globals.css

@@ -34,4 +34,9 @@ img.inline-block { display: inline-block !important; }
 .dark img.dark\:inline, .dark .dark\:inline { display: inline !important; }
 .dark img.dark\:inline-block, .dark .dark\:inline-block { display: inline-block !important; }
 
+/* SSR scroll lock — see lib/layout-helpers.tsx scrollLockBootstrap. */
+html[data-scroll-locked] #content-scroll-container {
+  overflow-y: hidden !important;
+}
+
 /* Shiki handles syntax highlighting via CSS variables - no theme import needed */

package/vendored/app/layout.tsx

@@ -23,6 +23,15 @@ import { fetchCustomCss, fetchCustomJs } from '@/lib/r2-content';
 import { DocsChrome, getLocalFileContent } from '@/lib/layout-helpers';
 
 export async function generateMetadata(): Promise<Metadata> {
+  // The placeholder shell would otherwise render with the paused
+  // project's title/favicon (and pay an R2 round-trip for it) — the
+  // nested (jd-system)/jd-inactive layout supplies neutral metadata.
+  if (isIsrMode()) {
+    const placeholderCheck = await headers();
+    if (placeholderCheck.get('x-jd-layout') === 'placeholder') {
+      return {robots: {index: false, follow: false}};
+    }
+  }
   let config: DocsConfig;
   if (isIsrMode()) {
     const headersList = await headers();
@@ -58,6 +67,33 @@ export default async function RootLayout({
 }) {
   const headersList = await headers();
 
+  // Placeholder short-circuit: proxy sets x-jd-layout=placeholder when
+  // rewriting an inactive site to /jd-inactive. Skip docs chrome (would
+  // otherwise leak the customer's nav, search, sidebar around our
+  // paused-site placeholder) and render a minimal dark shell.
+  if (headersList.get('x-jd-layout') === 'placeholder') {
+    return (
+      <html lang="en" suppressHydrationWarning>
+        <head>
+          <meta name="viewport" content="width=device-width, initial-scale=1" />
+          <meta name="robots" content="noindex, nofollow" />
+          <meta name="theme-color" content="#0a0a0d" />
+        </head>
+        <body
+          style={{
+            margin: 0,
+            minHeight: '100vh',
+            backgroundColor: '#0a0a0d',
+            colorScheme: 'dark',
+          }}
+          suppressHydrationWarning
+        >
+          {children}
+        </body>
+      </html>
+    );
+  }
+
   // Unlock-mode short-circuit: middleware sets x-jd-unlock-mode when
   // rewriting to /jd/unlock. Skip docs chrome — the unlock page renders
   // its own minimal shell via app/(unlock)/jd/unlock/page.tsx.

package/vendored/components/navigation/Header.tsx

@@ -59,8 +59,10 @@ export function Header({ config, layout = 'header-logo', tabsPosition: tabsPosit
   // Determine effective tabsPosition (same logic as Sidebar)
   const themeConfig = getTheme(config.theme);
 
-  // Nebula theme uses compact search (icon only) instead of full search bar
-  const useCompactSearch = config.theme === 'nebula';
+  // Nebula theme uses compact search (icon only) instead of full search bar.
+  // Read from `themeConfig.name` (canonical-case from registry) rather than
+  // `config.theme` so uppercase docs.json values like "NEBULA" still match.
+  const useCompactSearch = themeConfig.name === 'nebula';
   const effectiveTabsPosition: TabsPosition = config.tabsPosition || tabsPositionProp || themeConfig.defaultTabsPosition;
   const showTabsInHeader = effectiveTabsPosition === 'top';
   

package/vendored/components/navigation/SocialFooter.tsx

@@ -3,19 +3,9 @@
 import Image from 'next/image';
 import type { DocsConfig, SocialPlatform, FooterLinkColumn } from '@/lib/docs-types';
 import { getIconClass } from '@/lib/icon-utils';
+import { getBrandingUrl } from '@/lib/branding-url';
 
-// Branding configuration (read at build time from environment variables)
-// Uses NEXT_PUBLIC_ prefix so these are inlined during build for client components
-const showBranding = process.env.NEXT_PUBLIC_SHOW_BRANDING !== 'false'; // Default true
-
-/**
- * Generate branding URL with UTM parameters for attribution tracking.
- * projectSlug is passed as a prop (works in ISR multi-tenant mode).
- * Falls back to NEXT_PUBLIC_PROJECT_SLUG env var (works in CLI dev mode).
- */
-function getBrandingUrl(projectSlug: string): string {
-  return `https://www.jamdesk.com?utm_campaign=poweredBy&utm_medium=referral&utm_source=${projectSlug}`;
-}
+const showBranding = process.env.NEXT_PUBLIC_SHOW_BRANDING !== 'false';
 
 interface SocialFooterProps {
   config: DocsConfig;
@@ -150,23 +140,19 @@ export function SocialFooter({ config, hidden, projectSlug }: SocialFooterProps)
     return null;
   }
 
-  // Resolve slug: prop (ISR) → env var (CLI dev) → fallback
-  const slug = projectSlug || process.env.NEXT_PUBLIC_PROJECT_SLUG || 'docs';
-
   return (
     <footer className="mt-12 sm:mt-16 pt-6 sm:pt-8 border-t border-[var(--color-border)]">
       {hasLinks && <LinkColumns columns={links} />}
-      {/* Desktop: row layout, Mobile: column layout */}
       <div className="flex flex-col sm:flex-row sm:items-center sm:justify-between gap-4">
         {hasSocials && <SocialIcons socials={socials} />}
         {showBranding && (
           <a
-            href={getBrandingUrl(slug)}
+            href={getBrandingUrl(projectSlug)}
             target="_blank"
             rel="noopener noreferrer"
             className="group flex items-center gap-1 text-sm text-[#AEAEAE] hover:text-[#6A6D70] transition-colors whitespace-nowrap"
           >
-            <span>Powered by</span>
+            Powered by
             <span className="relative inline-block w-[58px] h-[15px] top-[1px]">
               <Image
                 src="/_jd/branding/jamdesk-wordmark.svg"

package/vendored/lib/branding-url.ts

@@ -0,0 +1,9 @@
+// `NEXT_PUBLIC_PROJECT_SLUG` is read inline so Next.js inlines the value at build
+// time for client components (SocialFooter). Hoisting the read would defeat the
+// inline. Server components (the unlock page) just see it as runtime env.
+export function getBrandingUrl(projectSlug?: string | null): string {
+  const slug = encodeURIComponent(
+    projectSlug || process.env.NEXT_PUBLIC_PROJECT_SLUG || 'docs'
+  );
+  return `https://www.jamdesk.com?utm_campaign=poweredBy&utm_medium=referral&utm_source=${slug}`;
+}

package/vendored/lib/build/error-parser.ts

@@ -1,5 +1,6 @@
 import type { ErrorDetails } from '../../shared/types.js';
 import { DEPRECATED_COMPONENTS } from '../deprecated-components.js';
+import { MIGRATION_DOCS_URL } from '../validate-config.js';
 
 /** Format: ERR-XXXXXXXX (first 8 chars of buildId, uppercase) */
 export function generateErrorRef(buildId: string): string {
@@ -108,6 +109,31 @@ export function parseErrorDetails(
   // Extract error source information upfront - used by multiple error types
   const errorSource = extractErrorSource(output, pageToFileMap);
 
+  // Mintlify migration needed — must come before the generic config_error branch
+  // so the migrate-specific suggestion wins. We match on the migration docs URL
+  // (which every Mintlify-detection branch in validate-config embeds) rather than
+  // a prose phrase, so future copy edits can't silently break the contract.
+  if (message.includes(MIGRATION_DOCS_URL)) {
+    return {
+      type: 'config_error',
+      message: 'Mintlify config detected — migration needed',
+      details: message,
+      suggestion:
+        'Your docs.json is still configured for Mintlify. Jamdesk includes a ' +
+        'tool that converts Mintlify projects automatically.\n\n' +
+        'From your project\'s root directory, run:\n\n' +
+        '  npm install -g jamdesk\n' +
+        '  jamdesk migrate\n\n' +
+        'The migration will:\n' +
+        '• Convert mint.json / docs.json to the Jamdesk format\n' +
+        '• Update the theme to "jam"\n' +
+        '• Convert Mintlify-only MDX components (e.g. <CardGroup> → <Columns>)\n' +
+        '• Rewrite parent-relative snippet imports\n\n' +
+        'Then commit the changes and push — the next build will pick them up.\n\n' +
+        'Full guide: https://jamdesk.com/docs/setup/migration',
+    };
+  }
+
   // Configuration validation errors (from validate phase)
   if (message.includes('Missing docs.json') || message.includes('Invalid docs.json')) {
     return {

package/vendored/lib/docs-isr.ts

@@ -12,6 +12,7 @@
 
 import fs from 'fs';
 import path from 'path';
+import { cache } from 'react';
 import {
   fetchDocsConfig,
   fetchMdxContent,
@@ -72,17 +73,19 @@ function walkMdx(dir: string): string[] {
   return out;
 }
 
-/**
- * Get docs.json configuration for a project.
- *
- * In ISR mode, fetches from R2 with in-memory caching (1 minute TTL).
- * Throws an error if the project doesn't exist.
- *
- * @param projectSlug - The project identifier (e.g., 'acme')
- * @returns Parsed docs.json configuration
- * @throws Error if project doesn't exist in R2
- */
-export async function getDocsConfig(projectSlug: string): Promise<DocsConfig> {
+// React cache() — request-scoped memoization. Layered on top of Next.js
+// Data Cache (which fetchDocsConfig already wraps via unstable_cache) so
+// repeated calls within the same render pass don't re-enter the Data Cache
+// either. Production fra1 logs showed 3 R2 fetches per request from
+// layout.generateMetadata + layout render + content-loader.getConfig — when
+// they all hit a Data Cache miss simultaneously (fresh region/cold cache),
+// each pays a cross-continent round-trip (~300ms each). cache() collapses
+// these to one in-flight promise.
+//
+// Caveat: cache() is documented to dedupe across generateMetadata + page
+// render in the same request, but historical Next.js bugs (#50080, #67133)
+// occasionally split contexts. In the worst case this still reduces 3→2.
+async function getDocsConfigUncached(projectSlug: string): Promise<DocsConfig> {
   requireIsrMode();
   const config = await fetchDocsConfig(projectSlug);
   if (config) return config;
@@ -99,6 +102,14 @@ export async function getDocsConfig(projectSlug: string): Promise<DocsConfig> {
   throw new Error(`Project not found in R2: ${projectSlug}`);
 }
 
+/**
+ * Get docs.json configuration for a project.
+ *
+ * Request-scoped (React cache) on top of Next.js Data Cache. Same projectSlug
+ * within one render → one R2 fetch.
+ */
+export const getDocsConfig = cache(getDocsConfigUncached);
+
 /**
  * Get all document paths for a project.
  *
@@ -114,14 +125,7 @@ export async function getAllDocPaths(projectSlug: string): Promise<string[]> {
   return listAllPaths(projectSlug);
 }
 
-/**
- * Get raw MDX content for a page.
- *
- * @param projectSlug - The project identifier
- * @param pagePath - Path to the page (e.g., 'api/auth')
- * @returns Raw MDX content string
- */
-export async function getMdxContent(
+async function getMdxContentUncached(
   projectSlug: string,
   pagePath: string
 ): Promise<string> {
@@ -141,6 +145,16 @@ export async function getMdxContent(
   }
 }
 
+/**
+ * Get raw MDX content for a page.
+ *
+ * Request-scoped (React cache) so generateMetadata's frontmatter read and
+ * the subsequent page render share one R2 fetch instead of paying it twice.
+ * Production fra1 logs showed every page making 2× fetchMdxContent calls
+ * for the same path (~600ms duplicated work per request).
+ */
+export const getMdxContent = cache(getMdxContentUncached);
+
 /**
  * Get snippet content.
  *

package/vendored/lib/docs-types.ts

@@ -758,7 +758,7 @@ export interface SpellcheckConfig {
 export interface PasswordAuthConfig {
   /** Opt in to password protection. Site is only gated when this is true AND a password has been set in the dashboard. */
   enabled?: boolean;
-  /** Optional hint shown on the unlock page (e.g., "Ask your account manager"). Plain text, no HTML. */
+  /** Optional hint shown on the unlock page (e.g., "Ask #docs-access on Slack"). Plain text, no HTML. */
   hint?: string;
   /** Paths or globs that bypass the password check. Supports '*' (one path segment) and '**' (recursive). */
   public?: string[];

package/vendored/lib/email-notifier.ts

@@ -38,7 +38,7 @@ export async function sendInternalBuildFailureEmail(info: BuildFailureEmailInfo)
     const result = await resend.emails.send({
       from: 'Jamdesk <no-reply@mail.jamdesk.com>',
       to: reportEmail,
-      subject: `[Jamdesk] Build Failed: ${info.projectName || info.projectId}`,
+      subject: `Jamdesk build failed: ${info.projectName || info.projectId}`,
       html,
       text,
     });

package/vendored/lib/isr-build-executor.ts

@@ -294,7 +294,7 @@ export const ISR_PHASES = {
   optimize_images: { label: 'Optimizing images...', weight: 5 },
   r2_upload: { label: 'Uploading to CDN...', weight: 35 },
   embeddings: { label: 'Indexing AI search + chat...', weight: 5 },
-  vercel_purge: { label: 'Refreshing cache...', weight: 20 },
+  vercel_purge: { label: 'Refreshing cache...', weight: 10 },
   cleanup: { label: 'Cleaning up...', weight: 5 },
 } as const;