jamdesk 1.1.18 → 1.1.20

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';
 
@@ -60,7 +60,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,7 +180,7 @@ 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 {
   const navigation = config.navigation;
@@ -256,7 +256,7 @@ function findFirstPage(config: ReturnType<typeof getDocsConfig>): string {
     }
   }
 
-  // Check pages array (Mintlify format with groups inside pages)
+  // Check pages array (flat format with groups inside pages)
   if (navigation.pages && Array.isArray(navigation.pages)) {
     for (const item of navigation.pages) {
       // Could be a string page
@@ -286,7 +286,6 @@ export async function generateStaticParams() {
   const paths = getAllDocPaths();
 
   // Filter out pages with relative MDX imports (not supported by next-mdx-remote)
-  // These are test pages in the Mintlify docs that test a Mintlify-specific feature
   const unsupportedPatterns = [
     'deep-relative-test',
     'relative-snippets-test',
@@ -302,7 +301,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) => ({
@@ -337,19 +336,12 @@ 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 slug = normalizedSlug.length > 0
+    ? normalizedSlug
+    : pathToSlug(findFirstPage(await loader.getConfig()));
   const pagePath = slug.join('/');
 
   // Fetch content and config in parallel
@@ -387,6 +379,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.
+    ...(normalizedSlug.length === 0 && { robots: { index: false, follow: true } }),
     ...(data.rss ? {
       alternates: {
         ...seoMetadata.alternates,
@@ -424,27 +419,16 @@ 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 request → render the first page in place instead of 307'ing
+  // to /{firstPage} (Lighthouse flagged ~1.5s mobile; Next's redirect() emits
+  // cache-control: private so CDNs can't absorb it). Canonical URL still
+  // points at /{firstPage} via buildSeoMetadata, and generateMetadata
+  // noindexes the root to prevent duplicate indexing.
+  const normalizedSlug = normalizeSlugForContent(resolvedParams.slug || [], hostAtDocs);
+  const slug = normalizedSlug.length > 0
+    ? normalizedSlug
+    : pathToSlug(findFirstPage(await loader.getConfig()));
   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/errors/NotFoundContent.tsx

@@ -61,7 +61,7 @@ export function NotFoundContent({ config }: NotFoundContentProps) {
       }
     }
 
-    // Check pages array (Mintlify format with groups inside pages)
+    // Check pages array (flat format with groups inside pages)
     if (navigation.pages && Array.isArray(navigation.pages)) {
       for (const item of navigation.pages) {
         // Could be a string page

package/vendored/components/mdx/OpenApiEndpoint.tsx

@@ -76,7 +76,7 @@ function renderSchemaType(schema: JsonSchema): string {
 }
 
 /**
- * Render nested schema properties - Mintlify style
+ * Render nested schema properties as a list of field items
  */
 function SchemaProperties({
   schema,
@@ -216,7 +216,7 @@ function BodyFieldItem({
 }
 
 /**
- * Authorization section - shows detailed auth requirements like Mintlify
+ * Authorization section - shows detailed auth requirements
  */
 function AuthorizationSection({ security }: { security: SecurityRequirement[] }) {
   if (security.length === 0) return null;
@@ -308,9 +308,9 @@ function ParameterSection({
             key={`${param.in}-${param.name}`} 
             className={`py-5 ${index < parameters.length - 1 ? 'param-divider' : ''}`}
           >
-            {/* Parameter name and type badges - Mintlify style */}
+            {/* Parameter name and type badges */}
             <div className="flex items-center gap-2 flex-wrap mb-2">
-              {/* Parameter name - plain bold text like Mintlify */}
+              {/* Parameter name - plain bold text */}
               <span
                 className="text-sm font-bold text-[var(--color-text-primary)]"
                 style={{ fontFamily: 'var(--font-mono, ui-monospace, monospace)' }}
@@ -478,7 +478,7 @@ function getResponseExample(response: ParsedResponse): unknown | null {
 }
 
 /**
- * Response section - Mintlify style with field documentation
+ * Response section with field documentation
  * Only shows response codes that have content (schema or example)
  */
 function ResponseSection({ 
@@ -504,7 +504,7 @@ function ResponseSection({
   
   return (
     <div className="mt-8">
-      {/* Response Header - Mintlify style with status code and content type on same line */}
+      {/* Response Header - status code and content type on same line */}
       <div className="flex items-center justify-between border-b border-[var(--color-border)] pb-3 mb-4">
         <h2 id="response" className="text-base font-semibold text-[var(--color-text-primary)] scroll-mt-20">
           Response
@@ -550,7 +550,7 @@ function ResponseSection({
         </p>
       )}
       
-      {/* Response Fields - Mintlify style field documentation */}
+      {/* Response Fields - structured field documentation */}
       {currentResponse?.content?.['application/json']?.schema && (
         <ResponseFieldsList schema={currentResponse.content['application/json'].schema} />
       )}
@@ -699,7 +699,7 @@ function FieldConstraints({ schema }: { schema: JsonSchema }) {
 }
 
 /**
- * Mintlify-style response fields list with parent prefix for nested fields
+ * Response fields list with parent prefix for nested fields
  * Handles typical API response schemas like { properties: { conference: { type: 'array', items: {...} } } }
  */
 function ResponseFieldsList({ 

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,6 +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';
+import { useProjectSlug } from '@/lib/project-slug-context';
 
 // Build-time env var for client-side configuration
 const projectSlug = process.env.NEXT_PUBLIC_PROJECT_SLUG || 'default';
@@ -103,6 +104,7 @@ function NoResultsState({ query, onSuggestionClick }: { query: string; onSuggest
 
 export function SearchModal({ isOpen, onClose, popularPages, onNavigate }: SearchModalProps) {
   const linkPrefix = useLinkPrefix();
+  const analyticsProjectSlug = useProjectSlug();
   const [query, setQuery] = useState('');
   const [results, setResults] = useState<SearchResult[]>([]);
   const [selectedIndex, setSelectedIndex] = useState(0);
@@ -142,7 +144,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(analyticsProjectSlug, {
         type: 'search_query',
         query: lastSearchRef.current.query,
         resultsCount: lastSearchRef.current.resultsCount,
@@ -153,7 +155,7 @@ export function SearchModal({ isOpen, onClose, popularPages, onNavigate }: Searc
       hasTrackedRef.current = false;
       lastSearchRef.current = null;
     }
-  }, [isOpen]);
+  }, [isOpen, analyticsProjectSlug]);
 
   // Load search data and recent searches on mount
   useEffect(() => {
@@ -263,7 +265,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(analyticsProjectSlug, {
           type: 'search_query',
           query: query.trim(),
           resultsCount: 0,
@@ -301,19 +303,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, analyticsProjectSlug]);
 
   const handleResultClick = (result: SearchResult, index: number) => {
     if (query.trim()) {
       // Track search_query event (the search itself)
-      trackSearch({
+      trackSearch(analyticsProjectSlug, {
         type: 'search_query',
         query: query.trim(),
         resultsCount: results.length,
       });
 
       // Track search_click event (the result they clicked)
-      trackSearch({
+      trackSearch(analyticsProjectSlug, {
         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,8 +1,11 @@
 // Search Analytics Client
-// Tracks search queries and clicks for analytics dashboard
+// Tracks search queries and clicks for analytics dashboard.
+//
+// Endpoint is /_jd/search-ev (not /api/search-ev) so that sites fronted by
+// the jamdesk.com Cloudflare Worker — which only proxies /_jd/* — route the
+// request to 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.
@@ -16,7 +19,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('') +
@@ -50,20 +52,21 @@ 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.
+ * The project slug MUST be supplied at runtime (typically via `useProjectSlug()`
+ * from `lib/project-slug-context`). Build-time env vars are not usable because
+ * the ISR deployment is multi-tenant and NEXT_PUBLIC_* vars are baked per-build.
+ *
+ * Fire-and-forget: returns immediately. The fetch runs in the background with
+ * `keepalive: true` so it survives page navigation. Errors are silently ignored.
  */
-export function trackSearch(event: SearchEvent): void {
+export function trackSearch(projectSlug: string, event: SearchEvent): void {
   // Don't track in development
   if (process.env.NODE_ENV === 'development') return;
 
-  const projectSlug = process.env.NEXT_PUBLIC_PROJECT_SLUG;
+  // Empty slug means we couldn't resolve the project (e.g., non-ISR fallback) — no-op
   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,8 +74,6 @@ 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' },

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';