jamdesk 1.1.19 → 1.1.21

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

@@ -1,4 +1,4 @@
-import { notFound, redirect } from 'next/navigation';
+import { notFound } from 'next/navigation';
 import { headers } from 'next/headers';
 import { MDXRemote } from 'next-mdx-remote/rsc';
 
@@ -47,7 +47,8 @@ import { mdxSecurityOptions } from '@/lib/mdx-security-options';
 import fs from 'fs';
 import path from 'path';
 import matter from 'gray-matter';
-import { getDocsConfig, getContentDir } from '@/lib/docs';
+import { getContentDir } from '@/lib/docs';
+import type { DocsConfig } from '@/lib/docs-types';
 import { buildSeoMetadata, generateAutoDescription, buildSiteTitle } from '@/lib/seo';
 import { buildJsonLd } from '@/lib/json-ld';
 import {
@@ -60,7 +61,7 @@ import {
   projectExists,
   type ContentLoader,
 } from '@/lib/content-loader';
-import { getBaseUrl } from '@/lib/page-isr-helpers';
+import { getBaseUrl, pathToSlug } from '@/lib/page-isr-helpers';
 import {
   parseOpenApiFrontmatter,
   getCachedSpec,
@@ -180,9 +181,9 @@ function getAllDocPaths(): string[] {
 }
 
 /**
- * Find the first page in navigation (for root redirect)
+ * Find the first page in navigation (used to resolve empty root slug in place).
  */
-function findFirstPage(config: ReturnType<typeof getDocsConfig>): string {
+function findFirstPage(config: DocsConfig): string {
   const navigation = config.navigation;
 
   // Helper to extract page path from a page entry
@@ -301,7 +302,7 @@ export async function generateStaticParams() {
     return !hasUnsupportedPattern;
   });
 
-  // Include empty slug for root route (will redirect to first page)
+  // Include empty slug for root route (resolves to first page in-place)
   return [
     { slug: [] },
     ...supportedPaths.map((path) => ({
@@ -336,19 +337,13 @@ export async function generateMetadata({ params }: PageProps) {
   // Get content loader (ISR: R2, static: filesystem)
   const loader = getContentLoader(projectSlug ?? undefined);
 
-  // Normalize slug: strip /docs prefix when hostAtDocs=true
+  // Normalize slug: strip /docs prefix when hostAtDocs=true.
+  // Empty root → resolve to first page (see DocPage for the full rationale).
   const normalizedSlug = normalizeSlugForContent(resolvedParams.slug || [], hostAtDocs);
-
-  // Handle root route - redirect case, no specific metadata needed
-  if (normalizedSlug.length === 0) {
-    const config = await loader.getConfig();
-    return {
-      title: { absolute: `${config.name} - Redirecting...` },
-      robots: { index: false }, // Don't index redirect page
-    };
-  }
-
-  const slug = normalizedSlug;
+  const isRoot = normalizedSlug.length === 0;
+  const slug = isRoot
+    ? pathToSlug(findFirstPage(await loader.getConfig()))
+    : normalizedSlug;
   const pagePath = slug.join('/');
 
   // Fetch content and config in parallel
@@ -386,6 +381,9 @@ export async function generateMetadata({ params }: PageProps) {
     title: titleValue,
     description: data.description || '',
     ...seoMetadata,
+    // Root serves first-page content but canonical points at /{firstPage};
+    // noindex as a second dedup signal alongside the canonical tag.
+    ...(isRoot && { robots: { index: false, follow: true } }),
     ...(data.rss ? {
       alternates: {
         ...seoMetadata.alternates,
@@ -423,27 +421,14 @@ export default async function DocPage({ params }: PageProps) {
   // Get content loader (ISR: R2, static: filesystem)
   const loader = getContentLoader(projectSlug ?? undefined);
 
-  // Normalize slug: strip /docs prefix when hostAtDocs=true
-  // This ensures content is looked up correctly regardless of URL structure
-  let slug = normalizeSlugForContent(resolvedParams.slug || [], hostAtDocs);
-
-  // Handle root route - redirect to first page (or render index directly)
-  // Next.js treats /index as root, so we must handle 'index' specially to avoid infinite redirect
-  if (slug.length === 0) {
-    const config = await loader.getConfig();
-    const firstPage = findFirstPage(config);
-
-    // If first page is 'index', render it directly (don't redirect to avoid loop)
-    if (firstPage === 'index') {
-      slug = ['index'];
-    } else {
-      // When hostAtDocs=true, redirect to /docs/firstPage; otherwise /firstPage
-      const redirectPath = hostAtDocs ? `/docs/${firstPage}` : `/${firstPage}`;
-      redirect(redirectPath);
-    }
-  }
-
-  // Load content and config in parallel
+  // Normalize slug: strip /docs prefix when hostAtDocs=true.
+  // Empty root renders the first page in place rather than 307'ing — Next's
+  // redirect() emits cache-control: private, blocking CDN caching. Canonical
+  // + noindex in generateMetadata prevent duplicate indexing.
+  const normalizedSlug = normalizeSlugForContent(resolvedParams.slug || [], hostAtDocs);
+  const slug = normalizedSlug.length === 0
+    ? pathToSlug(findFirstPage(await loader.getConfig()))
+    : normalizedSlug;
   const pagePath = slug.join('/');
   const [fileContents, config] = await Promise.all([
     loader.getContent(pagePath).catch(() => null),

package/vendored/app/layout.tsx

@@ -6,7 +6,8 @@ import { ThemeProvider } from '@/components/theme/ThemeProvider';
 import { LayoutWrapper } from '@/components/layout/LayoutWrapper';
 import { CodeBlockCopyButton } from '@/components/CodeBlockCopyButton';
 import { HeaderLinkCopy } from '@/components/HeaderLinkCopy';
-import { FontAwesomeLoader, FA_CSS_HREF } from '@/components/FontAwesomeLoader';
+import { FontAwesomeLoader } from '@/components/FontAwesomeLoader';
+import { FA_CSS_HREF } from '@/lib/font-awesome';
 import { getDocsConfig } from '@/lib/docs';
 import { getDocsConfig as getIsrDocsConfig } from '@/lib/docs-isr';
 import { isIsrMode, getProjectFromRequest, getHostAtDocs } from '@/lib/page-isr-helpers';
@@ -17,6 +18,7 @@ import path from 'path';
 import type { DocsConfig, Favicon, FontConfig } from '@/lib/docs-types';
 import { transformConfigImagePath } from '@/lib/docs-types';
 import { LinkPrefixProvider } from '@/lib/link-prefix-context';
+import { ProjectSlugProvider } from '@/lib/project-slug-context';
 import { getAnalyticsScript } from '@/lib/analytics-script';
 import { buildSiteTitle } from '@/lib/seo';
 import { fetchCustomCss, fetchCustomJs } from '@/lib/r2-content';
@@ -35,7 +37,7 @@ const jetbrainsMono = JetBrains_Mono({
 });
 
 /**
- * Get favicon path from config, applying asset prefix for /images/ paths.
+ * Get favicon path from config, routing it through the /_jd/ asset pipeline.
  * Returns undefined when no favicon is configured — no default Jamdesk
  * favicon is injected, so customers without a favicon get no icon.
  */
@@ -470,9 +472,14 @@ export default async function RootLayout({
       el.remove();
     });
   };
-  // Run immediately and observe for new elements
+  // Run immediately and observe for new elements once body exists
   removeDevIndicators();
-  new MutationObserver(removeDevIndicators).observe(document.body, { childList: true, subtree: true });
+  var observeBody = function() {
+    if (document.body) {
+      new MutationObserver(removeDevIndicators).observe(document.body, { childList: true, subtree: true });
+    }
+  };
+  if (document.body) { observeBody(); } else { document.addEventListener('DOMContentLoaded', observeBody, { once: true }); }
 })();
             `,
           }}
@@ -516,9 +523,11 @@ export default async function RootLayout({
           forcedTheme={appearanceStrict ? (appearanceDefault === 'system' ? undefined : appearanceDefault as 'light' | 'dark') : undefined}
         >
           <LinkPrefixProvider prefix={linkPrefix}>
-            <LayoutWrapper config={config}>
-              {children}
-            </LayoutWrapper>
+            <ProjectSlugProvider slug={resolvedProjectSlug || ''}>
+              <LayoutWrapper config={config}>
+                {children}
+              </LayoutWrapper>
+            </ProjectSlugProvider>
           </LinkPrefixProvider>
           {/* Client components for copy buttons after hydration */}
           <CodeBlockCopyButton />

package/vendored/components/FontAwesomeLoader.tsx

@@ -1,8 +1,9 @@
 'use client';
 
 import { useEffect } from 'react';
+import { FA_CSS_HREF } from '@/lib/font-awesome';
 
-export const FA_CSS_HREF = '/_jd/fonts/fontawesome/css/all.min.css';
+export { FA_CSS_HREF };
 
 /**
  * Ensures Font Awesome CSS is loaded in the document head.

package/vendored/components/mdx/YouTube.tsx

@@ -8,13 +8,15 @@ interface YouTubeProps {
   title?: string;
   /** Optional: Start time in seconds */
   start?: number;
+  /** Optional: Render as a vertical YouTube Short (9:16 aspect ratio) */
+  short?: boolean;
 }
 
 /**
- * Lazy-loaded YouTube video embed using lite-youtube-embed.
- * Video iframe only loads when user clicks play.
+ * YouTube video embed. Standard videos use lite-youtube-embed (lazy-loaded,
+ * iframe only loads on click). Shorts use a direct iframe with 9:16 aspect ratio.
  */
-export function YouTube({ id, title, start }: YouTubeProps): React.ReactElement | null {
+export function YouTube({ id, title, start, short }: YouTubeProps): React.ReactElement | null {
   if (!id) {
     console.warn('YouTube component requires an "id" prop');
     return null;
@@ -23,6 +25,22 @@ export function YouTube({ id, title, start }: YouTubeProps): React.ReactElement
   const startSeconds = start && start > 0 ? Math.floor(start) : undefined;
   const params = startSeconds ? `rel=0&start=${startSeconds}` : 'rel=0';
 
+  if (short) {
+    const src = `https://www.youtube.com/embed/${id}?${params}`;
+    return (
+      <div className="my-6 mx-auto max-w-[360px]">
+        <iframe
+          className="w-full aspect-[9/16] rounded-xl"
+          src={src}
+          title={title || 'YouTube Short'}
+          allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture"
+          allowFullScreen
+          loading="lazy"
+        />
+      </div>
+    );
+  }
+
   return (
     <div className="my-6 [&_lite-youtube]:rounded-xl [&_lite-youtube]:overflow-hidden">
       <YouTubeEmbed

package/vendored/components/search/SearchModal.tsx

@@ -8,9 +8,7 @@ import { useBodyScrollLock } from '@/hooks/useBodyScrollLock';
 import { getSuggestions } from '@/lib/search-suggestions';
 import { trackSearch } from '@/lib/analytics-client';
 import { useLinkPrefix } from '@/lib/link-prefix-context';
-
-// Build-time env var for client-side configuration
-const projectSlug = process.env.NEXT_PUBLIC_PROJECT_SLUG || 'default';
+import { useProjectSlug } from '@/lib/project-slug-context';
 
 interface SearchResult {
   id: string;
@@ -103,6 +101,7 @@ function NoResultsState({ query, onSuggestionClick }: { query: string; onSuggest
 
 export function SearchModal({ isOpen, onClose, popularPages, onNavigate }: SearchModalProps) {
   const linkPrefix = useLinkPrefix();
+  const projectSlug = useProjectSlug();
   const [query, setQuery] = useState('');
   const [results, setResults] = useState<SearchResult[]>([]);
   const [selectedIndex, setSelectedIndex] = useState(0);
@@ -142,7 +141,7 @@ export function SearchModal({ isOpen, onClose, popularPages, onNavigate }: Searc
   useEffect(() => {
     if (!isOpen && lastSearchRef.current && !hasTrackedRef.current) {
       // Modal closed with an untracked search - track it now
-      trackSearch({
+      trackSearch(projectSlug, {
         type: 'search_query',
         query: lastSearchRef.current.query,
         resultsCount: lastSearchRef.current.resultsCount,
@@ -153,15 +152,19 @@ export function SearchModal({ isOpen, onClose, popularPages, onNavigate }: Searc
       hasTrackedRef.current = false;
       lastSearchRef.current = null;
     }
-  }, [isOpen]);
+  }, [isOpen, projectSlug]);
 
-  // Load search data and recent searches on mount
+  // Load recent searches (depends on projectSlug from context, kept separate
+  // so search-data init doesn't re-fetch when the slug would hypothetically change)
   useEffect(() => {
     if (isOpen) {
-      // Load recent searches
       setRecentSearches(getRecentSearches(projectSlug));
+    }
+  }, [isOpen, projectSlug]);
 
-      // Initialize search
+  // Load search data on mount
+  useEffect(() => {
+    if (isOpen) {
       setIsInitializing(true);
       setInitError(null);
 
@@ -263,7 +266,7 @@ export function SearchModal({ isOpen, onClose, popularPages, onNavigate }: Searc
       else if (query.trim() && results.length === 0 && !isSearching && e.key === 'Enter') {
         e.preventDefault();
         // Track this as a committed search with zero results
-        trackSearch({
+        trackSearch(projectSlug, {
           type: 'search_query',
           query: query.trim(),
           resultsCount: 0,
@@ -301,19 +304,19 @@ export function SearchModal({ isOpen, onClose, popularPages, onNavigate }: Searc
 
     document.addEventListener('keydown', handleKeyDown);
     return () => document.removeEventListener('keydown', handleKeyDown);
-  }, [isOpen, query, recentSearches, results, selectedIndex, effectivePopularPages, popularIndex, router, onClose, onNavigate]);
+  }, [isOpen, query, recentSearches, results, selectedIndex, effectivePopularPages, popularIndex, router, onClose, onNavigate, projectSlug]);
 
   const handleResultClick = (result: SearchResult, index: number) => {
     if (query.trim()) {
       // Track search_query event (the search itself)
-      trackSearch({
+      trackSearch(projectSlug, {
         type: 'search_query',
         query: query.trim(),
         resultsCount: results.length,
       });
 
       // Track search_click event (the result they clicked)
-      trackSearch({
+      trackSearch(projectSlug, {
         type: 'search_click',
         query: query.trim(),
         resultsCount: results.length,

package/vendored/components/snippets/generated/CodeLink.tsx

@@ -0,0 +1,25 @@
+// Auto-generated file - do not edit manually
+// @ts-nocheck
+
+import React from 'react';
+
+// Import built-in MDX components that snippets can use
+import { Note, Info, Warning, Tip, Check, Danger, Callout } from '@/components/mdx/Callouts';
+import { Card } from '@/components/mdx/Card';
+import { CardGroup } from '@/components/mdx/CardGroup';
+import { ParamField } from '@/components/mdx/ParamField';
+import { ResponseField } from '@/components/mdx/ResponseField';
+import { Accordion, AccordionGroup } from '@/components/mdx/Accordion';
+import { CodeGroup } from '@/components/mdx/CodeGroup';
+import { Steps, Step } from '@/components/mdx/Steps';
+
+
+const CodeLink = ({ title, href }: any) => {
+  return (
+    <Card title={`${title}`} href={`${href}`} horizontal icon="code">
+      {" "}
+    </Card>
+  );
+};
+
+export default CodeLink;

package/vendored/components/snippets/generated/HeaderAPI.tsx

@@ -0,0 +1,44 @@
+// Auto-generated file - do not edit manually
+// @ts-nocheck
+
+import React from 'react';
+
+// Import built-in MDX components that snippets can use
+import { Note, Info, Warning, Tip, Check, Danger, Callout } from '@/components/mdx/Callouts';
+import { Card } from '@/components/mdx/Card';
+import { CardGroup } from '@/components/mdx/CardGroup';
+import { ParamField } from '@/components/mdx/ParamField';
+import { ResponseField } from '@/components/mdx/ResponseField';
+import { Accordion, AccordionGroup } from '@/components/mdx/Accordion';
+import { CodeGroup } from '@/components/mdx/CodeGroup';
+import { Steps, Step } from '@/components/mdx/Steps';
+
+
+const HeaderAPI = ({ noProfileKey, profileKeyRequired }: any) => (
+  <>
+    <ParamField header="Authorization" type="string" required>
+      <a href="/apis/overview#authorization">API Key</a> of the Primary Profile.
+      <br />
+      <br />
+      Format: <code>Authorization: Bearer API_KEY</code>
+    </ParamField>
+    {!noProfileKey &&
+      (profileKeyRequired ? (
+        <ParamField header="Profile-Key" type="string" required>
+          <a href="/apis/overview#profile-key-format">Profile Key</a> of a User Profile.
+          <br />
+          <br />
+          Format: <code>Profile-Key: PROFILE_KEY</code>
+        </ParamField>
+      ) : (
+        <ParamField header="Profile-Key" type="string">
+          <a href="/apis/overview#profile-key-format">Profile Key</a> of a User Profile.
+          <br />
+          <br />
+          Format: <code>Profile-Key: PROFILE_KEY</code>
+        </ParamField>
+      ))}
+  </>
+);
+
+export default HeaderAPI;

package/vendored/components/snippets/generated/PlansAvailable.tsx

@@ -0,0 +1,53 @@
+// Auto-generated file - do not edit manually
+// @ts-nocheck
+
+import React from 'react';
+
+// Import built-in MDX components that snippets can use
+import { Note, Info, Warning, Tip, Check, Danger, Callout } from '@/components/mdx/Callouts';
+import { Card } from '@/components/mdx/Card';
+import { CardGroup } from '@/components/mdx/CardGroup';
+import { ParamField } from '@/components/mdx/ParamField';
+import { ResponseField } from '@/components/mdx/ResponseField';
+import { Accordion, AccordionGroup } from '@/components/mdx/Accordion';
+import { CodeGroup } from '@/components/mdx/CodeGroup';
+import { Steps, Step } from '@/components/mdx/Steps';
+
+
+const PlansAvailable = ({ plans, maxPackRequired }: any) => {
+  let displayPlans = plans;
+
+if (plans.length === 1) {
+const lowerCasePlan = plans[0].toLowerCase();
+if (lowerCasePlan === "basic") {
+displayPlans = ["Basic", "Premium", "Business", "Enterprise"];
+} else if (lowerCasePlan === "business") {
+displayPlans = ["Business", "Enterprise"];
+} else if (lowerCasePlan === "premium") {
+displayPlans = ["Premium", "Business", "Enterprise"];
+}
+}
+
+return (
+
+<Note>
+Available on {displayPlans.length === 1 ? "the " : ""}
+{displayPlans.join(", ").replace(/\b\w/g, (l) => l.toUpperCase())}{" "}
+{displayPlans.length > 1 ? "plans" : "plan"}.
+
+{maxPackRequired && (
+
+  <a href="https://www.acme.com/docs/additional/maxpack"
+ className="flex items-center mt-2 cursor-pointer"
+>
+ <span className="px-1.5 py-0.5 rounded text-sm" style={{backgroundColor: '#C264B6', color: 'white', fontSize: '12px'}}>
+   Max Pack required
+ </span>
+</a>
+)}
+</Note>
+
+);
+};
+
+export default PlansAvailable;

package/vendored/lib/analytics-client.ts

@@ -1,11 +1,9 @@
-// Search Analytics Client
-// Tracks search queries and clicks for analytics dashboard
+// Endpoint is /_jd/search-ev (not /api/search-ev) so sites fronted by the
+// jamdesk.com Cloudflare Worker — which only proxies /_jd/* — reach the ISR
+// app. Middleware rewrites /_jd/search-ev to /api/search-ev.
 
-// Firebase Function URL for search analytics
-const ANALYTICS_URL = '/api/search-ev';
+const ANALYTICS_URL = '/_jd/search-ev';
 
-// Reuse the same session ID as the pageview tracking script (localStorage with 30-min inactivity timeout).
-// Every call refreshes the timestamp, so active users keep the same session.
 const SESSION_TIMEOUT_MS = 1800000; // 30 minutes
 
 function getSessionId(): string {
@@ -16,7 +14,6 @@ function getSessionId(): string {
   const sessionTs = localStorage.getItem('jamdesk_session_ts');
 
   if (!sessionId || !sessionTs || (now - parseInt(sessionTs)) >= SESSION_TIMEOUT_MS) {
-    // Match the tracking script's format: 16 random bytes as hex + timestamp in base36
     const bytes = new Uint8Array(16);
     crypto.getRandomValues(bytes);
     sessionId = Array.from(bytes, (b) => b.toString(16).padStart(2, '0')).join('') +
@@ -27,7 +24,6 @@ function getSessionId(): string {
   return sessionId;
 }
 
-// Use separate event types to avoid double-counting
 interface SearchQueryEvent {
   type: 'search_query';
   query: string;
@@ -48,22 +44,14 @@ interface SearchClickEvent {
 type SearchEvent = SearchQueryEvent | SearchClickEvent;
 
 /**
- * Track a search analytics event.
- *
- * Note: This function returns immediately without waiting for the request to complete.
- * The fetch request runs in the background with `keepalive: true` to survive page navigation.
- * Errors are silently ignored since analytics should never break the user experience.
+ * Fire-and-forget. The slug must be supplied at runtime (via `useProjectSlug()`)
+ * because `NEXT_PUBLIC_*` vars are baked per-build and the ISR app is multi-tenant.
  */
-export function trackSearch(event: SearchEvent): void {
-  // Don't track in development
+export function trackSearch(projectSlug: string, event: SearchEvent): void {
   if (process.env.NODE_ENV === 'development') return;
-
-  const projectSlug = process.env.NEXT_PUBLIC_PROJECT_SLUG;
   if (!projectSlug) return;
 
   try {
-    // Use fetch with keepalive for non-blocking analytics
-    // Note: sendBeacon with application/json triggers CORS preflight which can fail silently
     const payload = JSON.stringify({
       projectSlug,
       sessionId: getSessionId(),
@@ -71,17 +59,11 @@ export function trackSearch(event: SearchEvent): void {
       timestamp: Date.now(),
     });
 
-    // fetch with keepalive allows request to complete even if page navigates
-    // This is more reliable than sendBeacon for JSON payloads
     fetch(ANALYTICS_URL, {
       method: 'POST',
       headers: { 'Content-Type': 'application/json' },
       body: payload,
       keepalive: true,
-    }).catch(() => {
-      // Silent fail - analytics should never break the app
-    });
-  } catch {
-    // Silent fail - analytics should never break the app
-  }
+    }).catch(() => {});
+  } catch {}
 }

package/vendored/lib/docs-types.ts

@@ -741,6 +741,14 @@ export interface SpellcheckConfig {
   ignore?: string[];
 }
 
+/**
+ * Image optimization configuration
+ */
+export interface ImagesConfig {
+  /** Automatically convert PNG/JPG images to WebP format during build (default: false) */
+  convertToWebp?: boolean;
+}
+
 // =============================================================================
 // MAIN DOCS CONFIG
 // =============================================================================
@@ -807,6 +815,7 @@ export interface DocsConfig {
   analytics?: AnalyticsConfig;
   chat?: ChatConfig;
   spellcheck?: SpellcheckConfig;
+  images?: ImagesConfig;
 
   // Mintlify compatibility fields (normalized at load time)
   modeToggle?: ModeToggleConfig;
@@ -872,7 +881,7 @@ export function appendAssetVersion(url: string, assetVersion?: string): string {
 }
 
 /**
- * Transform an image path from /images/... to /_jd/images/...
+ * Transform a local asset path to /_jd/... for routing through the asset pipeline.
  *
  * Used for config-defined images (favicon, logo) that need the asset prefix.
  * Also normalizes relative paths and strips /public/ prefix (Next.js convention).
@@ -882,23 +891,22 @@ export function transformConfigImagePath(
   assetVersion?: string,
 ): string | undefined {
   if (!path) return path;
-  // Skip external URLs
-  if (path.startsWith('http://') || path.startsWith('https://') || path.startsWith('//')) {
+  if (path.startsWith('http://') || path.startsWith('https://') || path.startsWith('//') || path.startsWith('data:')) {
     return path;
   }
-  // Ensure absolute path — relative paths break on nested routes
+  // Relative paths break on nested routes
   let normalized = path.startsWith('/') ? path : `/${path}`;
   // Strip /public/ prefix (Next.js convention: public/logo.png served at /logo.png)
   normalized = normalized.replace(/^\/public\//, '/');
-  if (normalized.startsWith('/images/')) {
-    return appendAssetVersion(ASSET_PREFIX + normalized, assetVersion);
+  if (normalized.startsWith(ASSET_PREFIX + '/')) {
+    return normalized;
   }
-  return normalized;
+  return appendAssetVersion(ASSET_PREFIX + normalized, assetVersion);
 }
 
 /**
  * Normalize logo config to consistent object format.
- * Also transforms /images/... paths to /_jd/images/...
+ * Also transforms local paths to /_jd/... via transformConfigImagePath.
  */
 export function normalizeLogo(logo: Logo | undefined, assetVersion?: string): LogoConfig | null {
   if (!logo) return null;

package/vendored/lib/email-templates/build-failure.tsx

@@ -100,8 +100,11 @@ function formatPhase(phase?: string): string {
     validate: 'Configuration Validation',
     copy_content: 'Content Preparation',
     nextjs_build: 'Next.js Build',
+    optimize_images: 'Image Optimization',
     r2_upload: 'CDN Upload',
+    embeddings: 'AI Search Indexing',
     vercel_purge: 'Cache Refresh',
+    cleanup: 'Cleanup',
   };
   return phaseLabels[phase] || phase;
 }

package/vendored/lib/extract-highlights.ts

@@ -16,6 +16,7 @@ export interface ExtractedHighlights {
   redirectCount: number;
   pageCount: number;
   hasOpenApi: boolean;
+  imageOptimization: boolean;
   lastUpdatedAt: number;
 }
 
@@ -121,6 +122,7 @@ export function extractConfigHighlights(config: DocsConfig, pageCount: number =
     redirectCount: config.redirects?.length ?? 0,
     pageCount,
     hasOpenApi: hasOpenApiConfigured(config),
+    imageOptimization: config.images?.convertToWebp === true,
     lastUpdatedAt: Date.now(),
   };
 }

package/vendored/lib/font-awesome.ts

@@ -0,0 +1,2 @@
+/** Path to Font Awesome CSS — shared between server layout and client loader. */
+export const FA_CSS_HREF = '/_jd/fonts/fontawesome/css/all.min.css';

package/vendored/lib/indexnow.ts

@@ -60,6 +60,9 @@ export async function submitToIndexNow(
   }
 
   const submitted = Math.min(urls.length, MAX_BATCH_SIZE);
+  // keyLocation omitted — IndexNow requires it at the root level of the host,
+  // and our key verification route is at /api/indexnow/{key} (a subdirectory).
+  // When omitted, IndexNow defaults to /{key}.txt which it verifies asynchronously.
   const res = await fetch(INDEXNOW_ENDPOINT, {
     method: 'POST',
     headers: { 'Content-Type': 'application/json; charset=utf-8' },
@@ -67,7 +70,6 @@ export async function submitToIndexNow(
     body: JSON.stringify({
       host,
       key,
-      keyLocation: `https://${host}/api/indexnow/${key}`,
       urlList: urls.slice(0, MAX_BATCH_SIZE),
     }),
   });

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

@@ -205,7 +205,10 @@ export const ISR_PHASES = {
   copy_content: { label: 'Preparing content...', weight: 10 },
   // ISR mode: nextjs_build is instant (pages compiled on-demand by Vercel)
   nextjs_build: { label: 'Building documentation...', weight: 5 },
-  r2_upload: { label: 'Uploading to CDN...', weight: 40 },
+  // Only runs when docs.json `images.convertToWebp` is enabled; the dashboard
+  // auto-marks this row skipped when no timing entry is recorded.
+  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 },
   cleanup: { label: 'Cleaning up...', weight: 5 },

package/vendored/lib/page-isr-helpers.ts

@@ -61,6 +61,15 @@ export function normalizeSlugForContent(slug: string[], hostAtDocs: boolean): st
   return slug;
 }
 
+/**
+ * Split a page path (e.g. `"get-started/introduction"`) into the slug array
+ * Next.js expects. Collapses leading/trailing/repeated slashes so it accepts
+ * every shape `findFirstPage()` may return.
+ */
+export function pathToSlug(path: string): string[] {
+  return path.split('/').filter(Boolean);
+}
+
 /**
  * Get generateStaticParams result for ISR mode.
  *