jamdesk 1.0.10 → 1.0.12

package/dist/__tests__/unit/deploy-templates.test.js

@@ -52,10 +52,15 @@ describe('generateWorkerCode', () => {
         const code = generateWorkerCode(testConfig);
         expect(code).toContain('cacheEverything: true');
     });
-    it('does not cache server errors', () => {
+    it('does not cache redirects or server errors', () => {
         const code = generateWorkerCode(testConfig);
+        expect(code).toContain('"300-399": 0');
         expect(code).toContain('"500-599": 0');
     });
+    it('passes redirects through to browser', () => {
+        const code = generateWorkerCode(testConfig);
+        expect(code).toContain('redirect: "manual"');
+    });
 });
 describe('generateWranglerConfig', () => {
     it('generates valid TOML with catch-all route', () => {

package/dist/__tests__/unit/deploy-templates.test.js.map

@@ -1 +1 @@
-{"version":3,"file":"deploy-templates.test.js","sourceRoot":"","sources":["../../../src/__tests__/unit/deploy-templates.test.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"deploy-templates.test.js","sourceRoot":"","sources":["../../../src/__tests__/unit/deploy-templates.test.ts"],"names":[],"mappings":"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"}

package/dist/commands/deploy/templates.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"templates.d.ts","sourceRoot":"","sources":["../../../src/commands/deploy/templates.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAEnD,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,gBAAgB,GAAG,MAAM,CAuEnE;AAED,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,gBAAgB,GAAG,MAAM,CAuBvE;AAED,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,gBAAgB,GAAG,MAAM,CAqBpE;AAED;;GAEG;AACH,wBAAgB,iBAAiB,IAAI,MAAM,CAK1C;AAsCD;;;;;;;GAOG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAexD"}
+{"version":3,"file":"templates.d.ts","sourceRoot":"","sources":["../../../src/commands/deploy/templates.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAEnD,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,gBAAgB,GAAG,MAAM,CA4EnE;AAED,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,gBAAgB,GAAG,MAAM,CAuBvE;AAED,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,gBAAgB,GAAG,MAAM,CAqBpE;AAED;;GAEG;AACH,wBAAgB,iBAAiB,IAAI,MAAM,CAK1C;AAsCD;;;;;;;GAOG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAexD"}

package/dist/commands/deploy/templates.js

@@ -56,18 +56,23 @@ export default {
     // Custom header for domain verification (Vercel strips standard forwarding headers)
     headers.set("X-Jamdesk-Forwarded-Host", url.hostname);
 
+    // Don't follow redirects — let the browser handle them so the URL updates.
+    // Without this, redirects happen internally and the browser URL doesn't change,
+    // which causes the sidebar to mis-highlight the active page.
     const proxyRequest = new Request(proxyUrl, {
       method: request.method,
-      headers: headers,
+      headers,
       body: request.body,
+      redirect: "manual",
     });
 
     // Cache all content types at Cloudflare edge (CF doesn't cache HTML by default).
     // Cache duration is controlled by upstream Cache-Control headers.
+    // Never cache redirects or errors — they must always hit origin.
     return fetch(proxyRequest, {
       cf: {
         cacheEverything: true,
-        cacheTtlByStatus: { "500-599": 0 },
+        cacheTtlByStatus: { "300-399": 0, "500-599": 0 },
       },
     });
   },

package/dist/commands/deploy/templates.js.map

@@ -1 +1 @@
-{"version":3,"file":"templates.js","sourceRoot":"","sources":["../../../src/commands/deploy/templates.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"templates.js","sourceRoot":"","sources":["../../../src/commands/deploy/templates.ts"],"names":[],"mappings":"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"}

package/dist/lib/deps.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"deps.d.ts","sourceRoot":"","sources":["../../src/lib/deps.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAuGH,wBAAsB,kBAAkB,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,MAAM,CAAC,CAqF1E;AAED;;GAEG;AACH,wBAAgB,aAAa,IAAI,MAAM,CAEtC;AAED;;GAEG;AACH,wBAAgB,eAAe,IAAI,MAAM,CAExC"}
+{"version":3,"file":"deps.d.ts","sourceRoot":"","sources":["../../src/lib/deps.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAyGH,wBAAsB,kBAAkB,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,MAAM,CAAC,CAqF1E;AAED;;GAEG;AACH,wBAAgB,aAAa,IAAI,MAAM,CAEtC;AAED;;GAEG;AACH,wBAAgB,eAAe,IAAI,MAAM,CAExC"}

package/dist/lib/deps.js

@@ -57,6 +57,8 @@ const REQUIRED_DEPS = {
     'katex': '^0.16.28',
     // Diagrams
     'mermaid': '^11.12.2',
+    // YAML parsing (for OpenAPI specs)
+    'js-yaml': '^4.1.1',
     // Schema validation
     'ajv': '^8.17.1',
     // MDX compilation (for validate command)
@@ -76,7 +78,7 @@ const REQUIRED_DEPS = {
     // Script dependencies (for vendored scripts)
     'fs-extra': '^11.3.3',
     'json5': '^2.2.3',
-    'glob': '^13.0.3',
+    'glob': '^13.0.6',
     // TypeScript (needed for Next.js to avoid auto-install breaking symlink)
     'typescript': '^5.3.3',
     '@types/node': '^25.2.0',

package/dist/lib/deps.js.map

@@ -1 +1 @@
-{"version":3,"file":"deps.js","sourceRoot":"","sources":["../../src/lib/deps.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,KAAK,EAAE,MAAM,eAAe,CAAC;AACtC,OAAO,MAAM,MAAM,QAAQ,CAAC;AAC5B,OAAO,EAAE,MAAM,UAAU,CAAC;AAC1B,OAAO,IAAI,MAAM,MAAM,CAAC;AACxB,OAAO,EAAE,OAAO,EAAE,MAAM,IAAI,CAAC;AAC7B,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AACrC,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AACvC,OAAO,EAAE,aAAa,EAAE,MAAM,QAAQ,CAAC;AAEvC,MAAM,OAAO,GAAG,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAC/C,MAAM,UAAU,GAAG,OAAO,CAAC,oBAAoB,CAAwB,CAAC;AAExE,MAAM,WAAW,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,EAAE,UAAU,CAAC,CAAC;AACrD,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,cAAc,CAAC,CAAC;AAExD,uCAAuC;AACvC,MAAM,aAAa,GAA2B;IAC5C,oBAAoB;IACpB,MAAM,EAAE,SAAS;IACjB,8CAA8C;IAC9C,6BAA6B,EAAE,SAAS;IACxC,eAAe,EAAE,SAAS;IAC1B,OAAO,EAAE,SAAS;IAClB,WAAW,EAAE,SAAS;IACtB,WAAW,EAAE,SAAS;IACtB,iBAAiB,EAAE,QAAQ;IAC3B,aAAa,EAAE,QAAQ;IACvB,QAAQ;IACR,mCAAmC,EAAE,QAAQ;IAC7C,oCAAoC,EAAE,QAAQ;IAC9C,qCAAqC,EAAE,QAAQ;IAC/C,mCAAmC,EAAE,QAAQ;IAC7C,gCAAgC,EAAE,QAAQ;IAC1C,cAAc,EAAE,UAAU;IAC1B,6BAA6B;IAC7B,aAAa,EAAE,QAAQ;IACvB,YAAY,EAAE,UAAU;IACxB,SAAS,EAAE,QAAQ;IACnB,qBAAqB;IACrB,cAAc,EAAE,SAAS;IACzB,gCAAgC,EAAE,SAAS;IAC3C,gBAAgB,EAAE,SAAS;IAC3B,OAAO,EAAE,SAAS;IAClB,iBAAiB,EAAE,SAAS;IAC5B,uBAAuB,EAAE,SAAS;IAClC,kBAAkB,EAAE,QAAQ;IAC5B,cAAc,EAAE,QAAQ;IACxB,aAAa,EAAE,QAAQ;IACvB,YAAY,EAAE,QAAQ;IACtB,aAAa,EAAE,QAAQ;IACvB,oBAAoB,EAAE,QAAQ;IAC9B,uBAAuB;IACvB,OAAO,EAAE,UAAU;IACnB,WAAW;IACX,SAAS,EAAE,UAAU;IACrB,oBAAoB;IACpB,KAAK,EAAE,SAAS;IAChB,yCAAyC;IACzC,aAAa,EAAE,QAAQ;IACvB,sDAAsD;IACtD,mBAAmB,EAAE,SAAS;IAC9B,4CAA4C;IAC5C,SAAS,EAAE,SAAS;IACpB,kBAAkB,EAAE,QAAQ;IAC5B,MAAM,EAAE,QAAQ;IAChB,MAAM;IACN,aAAa,EAAE,QAAQ;IACvB,sBAAsB,EAAE,QAAQ;IAChC,yBAAyB,EAAE,SAAS;IACpC,SAAS,EAAE,SAAS;IACpB,cAAc,EAAE,UAAU;IAC1B,6CAA6C;IAC7C,UAAU,EAAE,SAAS;IACrB,OAAO,EAAE,QAAQ;IACjB,MAAM,EAAE,SAAS;IACjB,yEAAyE;IACzE,YAAY,EAAE,QAAQ;IACtB,aAAa,EAAE,SAAS;IACxB,cAAc,EAAE,UAAU;IAC1B,kBAAkB,EAAE,SAAS;IAC7B,qBAAqB,EAAE,SAAS;CACjC,CAAC;AAWF;;;GAGG;AACH,SAAS,WAAW;IAClB,MAAM,QAAQ,GAAG,IAAI,CAAC,SAAS,CAAC,aAAa,EAAE,MAAM,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;IAClF,OAAO,MAAM,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,SAAS,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;AACjF,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,kBAAkB,CAAC,OAAgB;IACvD,MAAM,eAAe,GAAG,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,cAAc,CAAC,CAAC;IAC/D,MAAM,WAAW,GAAG,UAAU,CAAC,OAAO,CAAC;IACvC,MAAM,SAAS,GAAG,WAAW,EAAE,CAAC;IAEhC,0EAA0E;IAC1E,IAAI,EAAE,CAAC,UAAU,CAAC,eAAe,CAAC,EAAE,CAAC;QACnC,IAAI,CAAC;YACH,MAAM,GAAG,GAAG,MAAM,EAAE,CAAC,QAAQ,CAAC,eAAe,CAAqB,CAAC;YACnE,MAAM,YAAY,GAAG,GAAG,CAAC,eAAe,KAAK,WAAW,CAAC;YACzD,MAAM,SAAS,GAAG,GAAG,CAAC,SAAS,KAAK,SAAS,CAAC;YAE9C,IAAI,YAAY,IAAI,SAAS,EAAE,CAAC;gBAC9B,IAAI,OAAO;oBAAE,MAAM,CAAC,IAAI,CAAC,gCAAgC,CAAC,CAAC;gBAC3D,OAAO,QAAQ,CAAC;YAClB,CAAC;YAED,IAAI,OAAO,EAAE,CAAC;gBACZ,MAAM,MAAM,GAAG,CAAC,YAAY;oBAC1B,CAAC,CAAC,wBAAwB,GAAG,CAAC,eAAe,MAAM,WAAW,EAAE;oBAChE,CAAC,CAAC,cAAc,CAAC;gBACnB,MAAM,CAAC,IAAI,CAAC,0BAA0B,MAAM,GAAG,CAAC,CAAC;YACnD,CAAC;QACH,CAAC;QAAC,MAAM,CAAC;YACP,uCAAuC;QACzC,CAAC;IACH,CAAC;IAED,MAAM,IAAI,GAAG,OAAO,CAAC,6CAA6C,CAAC,CAAC;IAEpE,IAAI,CAAC;QACH,sBAAsB;QACtB,MAAM,EAAE,CAAC,SAAS,CAAC,WAAW,CAAC,CAAC;QAChC,MAAM,EAAE,CAAC,SAAS,CAAC,eAAe,EAAE;YAClC,IAAI,EAAE,mBAAmB;YACzB,OAAO,EAAE,IAAI;YACb,IAAI,EAAE,QAAQ;YACd,eAAe,EAAE,WAAW;YAC5B,SAAS,EAAE,SAAS;YACpB,YAAY,EAAE,aAAa;SAC5B,EAAE,EAAE,MAAM,EAAE,CAAC,EAAE,CAAC,CAAC;QAElB,0DAA0D;QAC1D,MAAM,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;YAC1C,MAAM,UAAU,GAAG,KAAK,CAAC,KAAK,EAAE,CAAC,SAAS,EAAE,cAAc,EAAE,YAAY,EAAE,WAAW,CAAC,EAAE;gBACtF,GAAG,EAAE,WAAW;gBAChB,KAAK,EAAE,OAAO,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,MAAM;aACpC,CAAC,CAAC;YAEH,mBAAmB;YACnB,MAAM,OAAO,GAAG,UAAU,CAAC,GAAG,EAAE;gBAC9B,UAAU,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;gBAC3B,MAAM,CAAC,IAAI,KAAK,CAAC,uCAAuC,CAAC,CAAC,CAAC;YAC7D,CAAC,EAAE,MAAM,CAAC,CAAC;YAEX,2CAA2C;YAC3C,IAAI,YAAY,GAAG,EAAE,CAAC;YACtB,IAAI,CAAC,OAAO,IAAI,UAAU,CAAC,MAAM,EAAE,CAAC;gBAClC,UAAU,CAAC,MAAM,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,EAAE;oBACpC,YAAY,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC;gBAClC,CAAC,CAAC,CAAC;YACL,CAAC;YAED,UAAU,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,IAAI,EAAE,EAAE;gBAC9B,YAAY,CAAC,OAAO,CAAC,CAAC;gBACtB,IAAI,IAAI,KAAK,CAAC,EAAE,CAAC;oBACf,OAAO,EAAE,CAAC;gBACZ,CAAC;qBAAM,CAAC;oBACN,MAAM,OAAO,GAAG,YAAY,CAAC,CAAC,CAAC,KAAK,YAAY,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;oBAC/D,MAAM,CAAC,IAAI,KAAK,CAAC,gCAAgC,IAAI,GAAG,OAAO,EAAE,CAAC,CAAC,CAAC;gBACtE,CAAC;YACH,CAAC,CAAC,CAAC;YAEH,UAAU,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,GAAG,EAAE,EAAE;gBAC7B,YAAY,CAAC,OAAO,CAAC,CAAC;gBACtB,MAAM,CAAC,GAAG,CAAC,CAAC;YACd,CAAC,CAAC,CAAC;QACL,CAAC,CAAC,CAAC;QAEH,IAAI,CAAC,OAAO,CAAC,wBAAwB,CAAC,CAAC;QACvC,OAAO,QAAQ,CAAC;IAClB,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IAAI,CAAC,IAAI,CAAC,gCAAgC,CAAC,CAAC;QAC5C,MAAM,KAAK,CAAC;IACd,CAAC;AACH,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,aAAa;IAC3B,OAAO,WAAW,CAAC;AACrB,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,eAAe;IAC7B,OAAO,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,WAAW,CAAC,CAAC;AAC7C,CAAC"}
+{"version":3,"file":"deps.js","sourceRoot":"","sources":["../../src/lib/deps.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "jamdesk",
-  "version": "1.0.10",
+  "version": "1.0.12",
   "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",
@@ -99,7 +99,7 @@
     "commander": "^14.0.3",
     "fastest-levenshtein": "^1.0.16",
     "fs-extra": "^11.2.0",
-    "glob": "^13.0.3",
+    "glob": "^13.0.6",
     "gray-matter": "^4.0.3",
     "json5": "^2.2.3",
     "ora": "^9.3.0"

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

@@ -610,9 +610,12 @@ export default async function DocPage({ params }: PageProps) {
               />
             )}
 
-            {/* Additional MDX content (e.g., ResponseExample) */}
+            {/* Additional MDX content — strip <ResponseExample> on OpenAPI pages
+                (auto-generated ResponseExamplePanel already handles responses) */}
             <MDXRemote
-              source={content}
+              source={openApiEndpointData
+                ? content.replace(/<ResponseExample>[\s\S]*?<\/ResponseExample>/g, '')
+                : content}
               components={AllComponentsWithInline}
               options={{
                 // Keep expression props (e.g. cols={2}) compatible under next-mdx-remote v6.

package/vendored/components/mdx/ApiPage.tsx

@@ -361,6 +361,24 @@ export function ApiPageWrapper({ children }: ApiPageWrapperProps) {
     return () => window.removeEventListener('resize', handleResize);
   }, [isDesktop, mounted, applyPanelHeights]);
 
+  // Recalculate sidebar panel heights when a CodePanel switches tabs
+  useEffect(() => {
+    if (!sidebarRef.current || !isDesktop || !mounted) return;
+
+    const handleTabChange = (e: Event) => {
+      const panel = (e.target as Element).closest('[data-code-panel]');
+      if (panel) {
+        // Invalidate cached measurement — content changed
+        panelDataRef.current.delete(panel);
+        requestAnimationFrame(() => applyPanelHeights());
+      }
+    };
+
+    const sidebar = sidebarRef.current;
+    sidebar.addEventListener('codepanel-tab-change', handleTabChange);
+    return () => sidebar.removeEventListener('codepanel-tab-change', handleTabChange);
+  }, [isDesktop, mounted, applyPanelHeights]);
+
   return (
     <div className="flex h-full">
       {/* Main content area with independent scroll */}

package/vendored/components/mdx/OpenApiEndpoint.tsx

@@ -877,10 +877,10 @@ function CodeExamplesSection({ examples }: { examples: CodeExamples }) {
  * Renders full endpoint documentation from OpenAPI spec data.
  * Composes existing ParamField, ResponseField, and CodeGroup components.
  */
-export function OpenApiEndpoint({ 
-  endpoint, 
+export function OpenApiEndpoint({
+  endpoint,
   codeExamples,
-  children 
+  children
 }: OpenApiEndpointProps) {
   const { 
     method, 

package/vendored/components/navigation/Breadcrumb.tsx

@@ -174,17 +174,77 @@ function findNavigationPath(config: DocsConfig, targetSlug: string): BreadcrumbI
 }
 
 /**
- * Get page title from frontmatter or slug
+ * Find the page's navigation title from docs.json config.
+ * Falls back to formatting the last slug segment.
  */
 function getPageTitle(slug: string[], config?: DocsConfig): string {
-  // For now, just format the last segment nicely
-  // TODO: Could read from frontmatter or navigation title
+  if (config) {
+    const targetSlug = slug.join('/');
+    const title = findPageNavTitle(config, targetSlug);
+    if (title) return title;
+  }
   const lastSegment = slug[slug.length - 1];
   return lastSegment
     .replace(/-/g, ' ')
     .replace(/\b\w/g, (l) => l.toUpperCase());
 }
 
+/**
+ * Search navigation for the page's title (from enhanced nav or page object).
+ */
+function findPageNavTitle(config: DocsConfig, targetSlug: string): string | null {
+  const nav = config.navigation;
+
+  function searchPages(pages: (NavigationPage | GroupConfig)[]): string | null {
+    for (const item of pages) {
+      if (typeof item === 'object' && 'group' in item) {
+        const groupItem = item as GroupConfig;
+        if (groupItem.pages) {
+          const found = searchPages(groupItem.pages);
+          if (found) return found;
+        }
+      } else {
+        const { path, title } = normalizeNavPage(item as NavigationPage);
+        if (path === targetSlug) return title;
+      }
+    }
+    return null;
+  }
+
+  function searchGroups(groups: GroupConfig[]): string | null {
+    for (const group of groups) {
+      if (group.pages) {
+        const found = searchPages(group.pages);
+        if (found) return found;
+      }
+    }
+    return null;
+  }
+
+  // Search all navigation structures
+  if (nav.languages) {
+    for (const lang of nav.languages) {
+      if (lang.tabs) {
+        for (const tab of lang.tabs) {
+          if (tab.groups) { const r = searchGroups(tab.groups); if (r) return r; }
+        }
+      }
+    }
+  }
+  if (nav.anchors) {
+    for (const anchor of nav.anchors) {
+      if (anchor.groups) { const r = searchGroups(anchor.groups); if (r) return r; }
+    }
+  }
+  if (nav.tabs) {
+    for (const tab of nav.tabs) {
+      if (tab.groups) { const r = searchGroups(tab.groups); if (r) return r; }
+    }
+  }
+  if (nav.groups) { const r = searchGroups(nav.groups); if (r) return r; }
+  return null;
+}
+
 export function Breadcrumb({ slug, config }: BreadcrumbProps) {
   const linkPrefix = useLinkPrefix();
   const homeLink = config ? `${linkPrefix}/${getFirstPage(config)}` : `${linkPrefix}/introduction`;

package/vendored/components/navigation/Sidebar.tsx

@@ -53,10 +53,11 @@ interface NavPageProps {
   pathname: string | null;
   layout: LayoutVariant;
   onPrefetch: (path: string) => void;
+  onNavigate: (href: string) => void;
   linkPrefix?: string; // e.g., '/docs' when hostAtDocs is true
 }
 
-export const NavPage = React.memo(function NavPage({ page, pathname, layout, onPrefetch, linkPrefix = '' }: NavPageProps) {
+export const NavPage = React.memo(function NavPage({ page, pathname, layout, onPrefetch, onNavigate, linkPrefix = '' }: NavPageProps) {
   const href = `${linkPrefix}/${page.path}`;
   const isActive = pathname === href;
   const colors = page.method ? methodColors[page.method] : null;
@@ -67,6 +68,7 @@ export const NavPage = React.memo(function NavPage({ page, pathname, layout, onP
         href={href}
         prefetch={false}
         onMouseEnter={() => onPrefetch(page.path)}
+        onClick={() => onNavigate(href)}
         className={`flex items-center gap-2 ${layout === 'header-logo' ? 'pr-3' : 'px-3'} py-1.5 rounded-lg text-sm transition-colors ${
           isActive
             ? 'text-[var(--color-primary)] nav-active'
@@ -92,6 +94,30 @@ export const NavPage = React.memo(function NavPage({ page, pathname, layout, onP
   );
 });
 
+/** Find the first page path in a group, searching items, pages, and nested groups */
+function findFirstPageInGroups(groups: ResolvedGroup[]): string | null {
+  for (const group of groups) {
+    // Prefer ordered items array (includes both pages and nested groups in order)
+    if (group.items) {
+      for (const item of group.items) {
+        if (item.type === 'page') return item.page.path;
+        if (item.type === 'group') {
+          const nested = findFirstPageInGroups([item.group]);
+          if (nested) return nested;
+        }
+      }
+    } else {
+      // Legacy format: pages + nested arrays
+      if (group.pages.length > 0) return group.pages[0].path;
+      if (group.nested) {
+        const nested = findFirstPageInGroups(group.nested);
+        if (nested) return nested;
+      }
+    }
+  }
+  return null;
+}
+
 /** Find all groups in the path from root to the page containing currentPath */
 function findGroupsContainingPath(groups: ResolvedGroup[], currentPath: string, parentNames: string[] = []): Set<string> {
   const result = new Set<string>();
@@ -121,8 +147,9 @@ export function Sidebar({ config, layout = 'header-logo', tabsPosition: tabsPosi
   const sidebarRef = useRef<HTMLElement>(null);
   const linkPrefix = useLinkPrefix();
 
-  // Optimistic pathname: use pending (from search navigation) until real pathname catches up
-  const handleSearchNavigate = useCallback((url: string) => {
+  // Optimistic navigation: immediately highlight clicked link while page loads.
+  // Strips hash fragments so anchor links (e.g. /page#section) match pathname.
+  const handleNavigate = useCallback((url: string) => {
     setPendingPathname(url.split('#')[0]);
   }, []);
 
@@ -148,26 +175,43 @@ export function Sidebar({ config, layout = 'header-logo', tabsPosition: tabsPosi
   // In sidebar-logo layout, logo and search are in sidebar
   const showLogoInSidebar = layout === 'sidebar-logo';
   const showSearchInSidebar = layout === 'sidebar-logo';
-  
+
   // Logo configuration
   const logoConfig = normalizeLogo(config.logo, config.assetVersion);
   const logoHref = logoConfig?.href || '/';
   const logoSrc = logoConfig ? (isDark && logoConfig.dark ? logoConfig.dark : logoConfig.light) : null;
   const showLogoImage = logoSrc && !logoError;
 
-  // Resolve navigation using the new resolver
+  // Resolve navigation structure (tab/anchor selection) using the raw pathname.
+  // Uses effectivePathname (not activePathname) because navigation resolution
+  // needs the actual URL for correct tab detection — activePathname is only for
+  // highlight matching within the resolved groups.
   const resolvedNav = useMemo(() => {
-    return resolveNavigation(config, effectivePathname || '/docs');
-  }, [config, effectivePathname]);
+    return resolveNavigation(config, effectivePathname || pathname || '/');
+  }, [config, effectivePathname, pathname]);
+
+  // Normalize bare root path to first page path for active state highlighting.
+  // When an upstream proxy (e.g., Cloudflare Worker) follows the server redirect
+  // from /docs → /docs/introduction internally, the browser URL stays at /docs.
+  // This causes usePathname() to return "/docs" which doesn't match any nav link.
+  // Map the bare root to the first page so the sidebar highlights correctly.
+  const activePathname = useMemo(() => {
+    if (!effectivePathname) return effectivePathname;
+    const rootPath = linkPrefix || '/';
+    if (effectivePathname !== rootPath) return effectivePathname;
+
+    const firstPage = findFirstPageInGroups(resolvedNav.groups);
+    return firstPage ? `${linkPrefix}/${firstPage}` : effectivePathname;
+  }, [effectivePathname, linkPrefix, resolvedNav.groups]);
 
   // Track if this is the initial mount (for resetting expanded state on refresh)
   const isInitialMount = useRef(true);
 
   // Memoize the groups that should be expanded for the current page
   const groupsForCurrentPage = useMemo(() => {
-    const currentPath = effectivePathname?.replace(/^\/(?:docs\/)?/, '') || '';
+    const currentPath = activePathname?.replace(/^\/(?:docs\/)?/, '') || '';
     return findGroupsContainingPath(resolvedNav.groups, currentPath);
-  }, [resolvedNav.groups, effectivePathname]);
+  }, [resolvedNav.groups, activePathname]);
 
   // Expand groups containing current page
   // On initial mount: reset to only current page's groups
@@ -239,7 +283,7 @@ export function Sidebar({ config, layout = 'header-logo', tabsPosition: tabsPosi
     });
 
     return () => cancelAnimationFrame(rafId);
-  }, [effectivePathname]);
+  }, [activePathname]);
 
   // Prevent body scroll when sidebar is open on mobile
   useEffect(() => {
@@ -253,16 +297,6 @@ export function Sidebar({ config, layout = 'header-logo', tabsPosition: tabsPosi
     };
   }, [isOpen]);
 
-  // Find the first page in a group (including nested groups)
-  function findFirstPageInGroup(g: ResolvedGroup): string | null {
-    if (g.pages.length > 0) return g.pages[0].path;
-    for (const nested of g.nested || []) {
-      const nestedFirst = findFirstPageInGroup(nested);
-      if (nestedFirst) return nestedFirst;
-    }
-    return null;
-  }
-
   // Toggle group expansion; if expanding, navigate to first page
   const handleGroupClick = useCallback((group: ResolvedGroup) => {
     setExpandedGroups(prev => {
@@ -270,7 +304,7 @@ export function Sidebar({ config, layout = 'header-logo', tabsPosition: tabsPosi
       if (prev.has(group.name)) {
         newSet.delete(group.name);
       } else {
-        const firstPagePath = findFirstPageInGroup(group);
+        const firstPagePath = findFirstPageInGroups([group]);
         if (firstPagePath) router.push(`${linkPrefix}/${firstPagePath}`);
         newSet.add(group.name);
       }
@@ -344,9 +378,10 @@ export function Sidebar({ config, layout = 'header-logo', tabsPosition: tabsPosi
                             <NavPage
                               key={p.page.path}
                               page={p.page}
-                              pathname={effectivePathname}
+                              pathname={activePathname}
                               layout={layout}
                               onPrefetch={handlePrefetch}
+                              onNavigate={handleNavigate}
                               linkPrefix={linkPrefix}
                             />
                           ))}
@@ -382,9 +417,10 @@ export function Sidebar({ config, layout = 'header-logo', tabsPosition: tabsPosi
                       <NavPage
                         key={page.path}
                         page={page}
-                        pathname={effectivePathname}
+                        pathname={activePathname}
                         layout={layout}
                         onPrefetch={handlePrefetch}
+                        onNavigate={handleNavigate}
                         linkPrefix={linkPrefix}
                       />
                     ))}
@@ -429,20 +465,7 @@ export function Sidebar({ config, layout = 'header-logo', tabsPosition: tabsPosi
             );
           }
 
-          // Find the first page in this anchor's groups
-          const findFirstPage = (groups: ResolvedGroup[]): string | null => {
-            for (const group of groups) {
-              if (group.pages.length > 0) {
-                return group.pages[0].path;
-              }
-              if (group.nested) {
-                const nestedFirst = findFirstPage(group.nested);
-                if (nestedFirst) return nestedFirst;
-              }
-            }
-            return null;
-          };
-          const firstPagePath = findFirstPage(anchor.groups);
+          const firstPagePath = findFirstPageInGroups(anchor.groups);
 
           return (
             <button
@@ -719,7 +742,7 @@ export function Sidebar({ config, layout = 'header-logo', tabsPosition: tabsPosi
       </aside>
 
       {/* Search Modal - shown when search is opened from sidebar */}
-      <SearchModal isOpen={isSearchOpen} onClose={() => setIsSearchOpen(false)} onNavigate={handleSearchNavigate} />
+      <SearchModal isOpen={isSearchOpen} onClose={() => setIsSearchOpen(false)} onNavigate={handleNavigate} />
     </>
   );
 }

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/components/snippets/generated/SnippetIntro.tsx

@@ -0,0 +1,43 @@
+// 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';
+
+
+// Helper component for rendering plain MDX snippets
+// Content is from project snippets (controlled source), not user input
+const PlainMdxSnippet = ({ content }: { content: string }) => {
+  const formattedContent = content
+    .split('\n\n')
+    .map((paragraph) => {
+      let html = paragraph.replace(/\*\*([^*]+)\*\*/g, '<strong>$1</strong>');
+      html = html.replace(/\*([^*]+)\*/g, '<em>$1</em>');
+      html = html.replace(/\`([^\`]+)\`/g, '<code>$1</code>');
+      return html;
+    })
+    .filter(p => p.trim());
+
+  return (
+    <div className="snippet-content">
+      {formattedContent.map((p, i) => (
+        <p key={i} dangerouslySetInnerHTML={{ __html: p }} />
+      ))}
+    </div>
+  );
+};
+
+const SnippetIntro = () => {
+  return <PlainMdxSnippet content={"One of the core principles of software development is DRY (Don't Repeat\nYourself). This is a principle that apply to documentation as\nwell. If you find yourself repeating the same content in multiple places, you\nshould consider creating a custom snippet to keep your content in sync."} />;
+};
+
+export default SnippetIntro;

package/vendored/components/ui/CodePanel.tsx

@@ -121,6 +121,7 @@ export function CodePanel({
   const [scrollRatio, setScrollRatio] = useState(0); // 0 to 1, for custom scrollbar position
   const [thumbWidth, setThumbWidth] = useState(30); // Percentage width of thumb
   const [isDragging, setIsDragging] = useState(false);
+  const panelRef = useRef<HTMLDivElement>(null);
   const tabsRef = useRef<HTMLDivElement>(null);
   const trackRef = useRef<HTMLDivElement>(null);
   const contentRef = useRef<HTMLDivElement>(null);
@@ -149,6 +150,11 @@ export function CodePanel({
     }
   };
 
+  // Notify parent (ApiPage) after tab content re-renders so sidebar heights recalculate
+  useEffect(() => {
+    panelRef.current?.dispatchEvent(new CustomEvent('codepanel-tab-change', { bubbles: true }));
+  }, [activeTab]);
+
   // Check for overflow and scroll position
   useEffect(() => {
     const checkOverflow = () => {
@@ -246,6 +252,7 @@ export function CodePanel({
 
   return (
     <div
+      ref={panelRef}
       className={`rounded-xl overflow-hidden not-prose w-full flex flex-col ${className}`}
       style={{ border: `0.5px solid ${codePanelColors.border}`, boxShadow: 'var(--shadow-lg)' }}
       data-code-panel={panelType || 'inline'}

package/vendored/lib/crypto-helpers.ts

@@ -0,0 +1,25 @@
+// DO NOT EDIT — this file is auto-synced from shared/. Edit the source in shared/ and run ./scripts/sync-shared.sh
+
+/**
+ * Shared Cryptographic Helpers
+ *
+ * Constant-time comparison using HMAC to avoid length-leak timing attacks.
+ *
+ * SYNC TARGET: This file is the source of truth.
+ * Synced to: builder/build-service/lib, proxy/lib
+ */
+import { timingSafeEqual, createHmac } from 'crypto';
+
+/**
+ * Constant-time string comparison using HMAC.
+ *
+ * Unlike naive timingSafeEqual (which requires equal-length buffers and
+ * leaks length via early return), this HMACs both values first so
+ * comparisons are always on fixed-length 32-byte digests.
+ */
+export function secretsEqual(a: string, b: string): boolean {
+  const key = 'jamdesk-secret-comparison';
+  const hmacA = createHmac('sha256', key).update(a).digest();
+  const hmacB = createHmac('sha256', key).update(b).digest();
+  return timingSafeEqual(hmacA, hmacB);
+}

package/vendored/lib/enhance-navigation.ts

@@ -0,0 +1,175 @@
+/**
+ * Navigation Enhancement
+ *
+ * Enhances docs.json navigation entries with metadata from MDX frontmatter:
+ * - Sidebar titles (sidebarTitle > title)
+ * - HTTP method badges (from openapi: or api: frontmatter)
+ * - Icons and tags
+ *
+ * Port of scripts/enhance-navigation.cjs for use in the production build pipeline.
+ */
+
+import type {
+  DocsConfig,
+  NavigationPage,
+  NavigationPageObject,
+  GroupConfig,
+} from './docs-types.js';
+
+type HttpMethod = NonNullable<NavigationPageObject['method']>;
+
+export interface PageInfo {
+  path: string;
+  frontmatter: Record<string, unknown>;
+  content: string;
+}
+
+const VALID_METHODS: readonly string[] = ['GET', 'POST', 'PUT', 'PATCH', 'DELETE'];
+
+/**
+ * Parse HTTP method from `api:` frontmatter field.
+ * Example: "POST /analytics/post" -> "POST"
+ */
+export function parseApiMethod(apiField: unknown): HttpMethod | null {
+  if (!apiField || typeof apiField !== 'string') return null;
+  const trimmed = apiField.trim().toUpperCase();
+  for (const method of VALID_METHODS) {
+    if (trimmed.startsWith(method)) return method as HttpMethod;
+  }
+  return null;
+}
+
+/**
+ * Parse HTTP method from `openapi:` frontmatter field.
+ * Example: "/openapi/spec.yml GET /api/v1/users" -> "GET"
+ */
+export function parseOpenApiMethod(openapiField: unknown): HttpMethod | null {
+  if (!openapiField || typeof openapiField !== 'string') return null;
+  const parts = openapiField.trim().split(/\s+/);
+  for (const part of parts) {
+    const upper = part.toUpperCase();
+    if (VALID_METHODS.includes(upper)) return upper as HttpMethod;
+  }
+  return null;
+}
+
+function buildFrontmatterMap(
+  pageInfos: PageInfo[],
+): Map<string, Record<string, unknown>> {
+  const map = new Map<string, Record<string, unknown>>();
+  for (const info of pageInfos) {
+    const pagePath = info.path.replace(/\.mdx?$/, '');
+    map.set(pagePath, info.frontmatter);
+  }
+  return map;
+}
+
+/**
+ * Enhance a single page entry with frontmatter data.
+ * Preserves existing explicit values — only fills in missing ones.
+ */
+function enhancePage(
+  page: NavigationPage,
+  map: Map<string, Record<string, unknown>>,
+): NavigationPage {
+  const pagePath = typeof page === 'string' ? page : page.page;
+  const existing: Partial<NavigationPageObject> =
+    typeof page === 'object' ? page : {};
+
+  const fm = map.get(pagePath);
+  if (!fm) return page;
+
+  // sidebarTitle takes priority over title for sidebar display
+  const title =
+    existing.title ||
+    (fm.sidebarTitle as string | undefined) ||
+    (fm.title as string | undefined);
+  const method =
+    existing.method || parseApiMethod(fm.api) || parseOpenApiMethod(fm.openapi);
+  const icon = existing.icon || (fm.icon as string | undefined);
+  const tag = existing.tag || (fm.tag as string | undefined);
+
+  if (title || method || icon || tag) {
+    return {
+      page: pagePath,
+      ...(title && { title }),
+      ...(method && { method }),
+      ...(icon && { icon }),
+      ...(tag && { tag }),
+    };
+  }
+
+  return page;
+}
+
+/**
+ * Recursively enhance all pages/groups in a navigation array.
+ */
+function enhancePages(
+  pages: (NavigationPage | GroupConfig)[],
+  map: Map<string, Record<string, unknown>>,
+): (NavigationPage | GroupConfig)[] {
+  return pages.map((item) => {
+    if (typeof item === 'object' && 'group' in item) {
+      return enhanceNavNode(
+        item as unknown as Record<string, unknown>,
+        map,
+      ) as unknown as GroupConfig;
+    }
+    return enhancePage(item as NavigationPage, map);
+  });
+}
+
+/** Navigation keys whose children are sub-nodes (recurse with enhanceNavNode). */
+const RECURSE_KEYS = [
+  'groups', 'tabs', 'anchors', 'dropdowns',
+  'products', 'versions', 'languages', 'menu',
+] as const;
+
+/**
+ * Generic recursive walker — enhances any navigation node that has
+ * pages, groups, tabs, anchors, dropdowns, products, versions,
+ * languages, or menu keys.
+ */
+function enhanceNavNode(
+  node: Record<string, unknown>,
+  map: Map<string, Record<string, unknown>>,
+): Record<string, unknown> {
+  const result = { ...node };
+
+  // Pages contain leaf page entries (strings or objects) mixed with nested groups
+  if (Array.isArray(node.pages)) {
+    result.pages = enhancePages(node.pages, map);
+  }
+
+  // All other array keys contain sub-nodes that need recursive enhancement
+  for (const key of RECURSE_KEYS) {
+    if (Array.isArray(node[key])) {
+      result[key] = (node[key] as Record<string, unknown>[]).map((child) =>
+        enhanceNavNode(child, map),
+      );
+    }
+  }
+
+  return result;
+}
+
+/**
+ * Enhance docs.json navigation with frontmatter metadata.
+ * Returns a new config — does NOT mutate the input.
+ */
+export function enhanceConfigNavigation(
+  config: DocsConfig,
+  pageInfos: PageInfo[],
+): DocsConfig {
+  const nav = config.navigation;
+  if (!nav || Object.keys(nav).length === 0) return config;
+
+  const map = buildFrontmatterMap(pageInfos);
+  const enhanced = enhanceNavNode(
+    nav as Record<string, unknown>,
+    map,
+  );
+
+  return { ...config, navigation: enhanced as DocsConfig['navigation'] };
+}

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

@@ -7,6 +7,7 @@
  * This module provides testable helper functions used by build.ts.
  */
 
+import fs from 'fs';
 import glob from 'fast-glob';
 
 /**
@@ -82,6 +83,19 @@ export async function collectSnippetFiles(projectDir: string): Promise<string[]>
   return files;
 }
 
+/** Collect OpenAPI spec files from project directory. Returns paths relative to openapi/. */
+export async function collectOpenApiFiles(projectDir: string): Promise<string[]> {
+  const openapiDir = `${projectDir}/openapi`;
+  if (!fs.existsSync(openapiDir)) return [];
+
+  const files = await glob('**/*.{yaml,yml,json}', {
+    cwd: openapiDir,
+    ignore: ['node_modules/**'],
+  });
+
+  return files;
+}
+
 /**
  * Options for getting project base URL.
  */
@@ -137,6 +151,8 @@ export interface IsrBuildResult {
   assetCount: number;
   /** Number of snippets uploaded */
   snippetCount: number;
+  /** Number of OpenAPI spec files uploaded */
+  openapiCount: number;
   /** Paths that were revalidated */
   revalidatedPaths: string[];
   /** Build duration in milliseconds */

package/vendored/lib/openapi-isr.ts

@@ -5,7 +5,9 @@
  * with caching for ISR mode rendering.
  */
 
-import { fetchSnippet } from './r2-content';
+import yaml from 'js-yaml';
+import SwaggerParser from '@apidevtools/swagger-parser';
+import { fetchOpenApiFile } from './r2-content';
 
 interface OpenApiSpec {
   openapi?: string;
@@ -19,12 +21,7 @@ interface OpenApiSpec {
 const specCache = new Map<string, { spec: OpenApiSpec; timestamp: number }>();
 const CACHE_TTL = 600_000; // 10 minutes
 
-/**
- * Fetch OpenAPI spec from external URL.
- *
- * @param url - Full URL to OpenAPI spec
- * @returns Parsed OpenAPI specification
- */
+/** Fetch OpenAPI spec from external URL. */
 export async function fetchOpenApiSpec(url: string): Promise<OpenApiSpec> {
   // Check cache
   const cached = specCache.get(url);
@@ -51,9 +48,8 @@ export async function fetchOpenApiSpec(url: string): Promise<OpenApiSpec> {
 /**
  * Fetch OpenAPI spec from R2 (project-local spec file).
  *
- * @param projectSlug - Project identifier
- * @param specPath - Path to spec file in project (e.g., 'openapi/spec.json')
- * @returns Parsed OpenAPI specification
+ * Handles both YAML and JSON formats, and resolves all internal $ref
+ * references (matching the static mode behavior of SwaggerParser.validate).
  */
 export async function fetchOpenApiSpecFromR2(
   projectSlug: string,
@@ -67,8 +63,14 @@ export async function fetchOpenApiSpecFromR2(
     return cached.spec;
   }
 
-  const content = await fetchSnippet(projectSlug, specPath);
-  const spec = JSON.parse(content) as OpenApiSpec;
+  const content = await fetchOpenApiFile(projectSlug, specPath);
+
+  // Parse YAML or JSON into a plain object
+  const isYaml = /\.ya?ml$/i.test(specPath);
+  const raw = isYaml ? yaml.load(content) : JSON.parse(content);
+
+  // Dereference all $ref pointers (matching static mode's SwaggerParser.validate behavior)
+  const spec = await SwaggerParser.dereference(raw as any) as unknown as OpenApiSpec;
 
   // Cache it
   specCache.set(cacheKey, { spec, timestamp: Date.now() });
@@ -79,10 +81,6 @@ export async function fetchOpenApiSpecFromR2(
 /**
  * Resolve OpenAPI spec from config reference.
  * Handles both URLs and local file references.
- *
- * @param projectSlug - Project identifier
- * @param specRef - URL or local path to spec
- * @returns Parsed OpenAPI specification
  */
 export async function resolveOpenApiSpec(
   projectSlug: string,
@@ -96,11 +94,7 @@ export async function resolveOpenApiSpec(
   return fetchOpenApiSpecFromR2(projectSlug, specRef);
 }
 
-/**
- * Clear OpenAPI cache.
- *
- * @param projectSlug - Optional project to clear. If not provided, clears all.
- */
+/** Clear OpenAPI cache. If projectSlug is provided, clears only that project. */
 export function clearOpenApiCache(projectSlug?: string): void {
   if (projectSlug) {
     for (const key of specCache.keys()) {
@@ -113,9 +107,7 @@ export function clearOpenApiCache(projectSlug?: string): void {
   }
 }
 
-/**
- * Get the current size of the OpenAPI spec cache.
- */
+/** Get the current size of the OpenAPI spec cache. */
 export function getOpenApiCacheSize(): number {
   return specCache.size;
 }

package/vendored/lib/r2-content.ts

@@ -36,6 +36,10 @@ export async function fetchSnippet(_projectSlug: string, _snippetPath: string):
   throw new Error('R2 snippet fetching not available in dev mode');
 }
 
+export async function fetchOpenApiFile(_projectSlug: string, _specPath: string): Promise<string> {
+  throw new Error('R2 OpenAPI fetching not available in dev mode');
+}
+
 export async function listAllPaths(_projectSlug: string): Promise<string[]> { return []; }
 
 export interface Manifest {
@@ -44,6 +48,7 @@ export interface Manifest {
   projectSlug?: string;
   files: Record<string, { hash: string; size?: number }>;
   snippets?: Record<string, { hash: string }>;
+  openapi?: Record<string, { hash: string }>;
   configHash?: string;
 }
 

package/vendored/lib/revalidation-trigger.ts

@@ -99,6 +99,7 @@ async function revalidateProxy(secret: string, projectSlug: string): Promise<voi
 
 export interface Manifest {
   files: Record<string, { hash: string }>;
+  openapi?: Record<string, { hash: string }>;
 }
 
 /** Compare manifests and return paths that changed (without .mdx extension). */
@@ -128,9 +129,29 @@ export function getChangedPaths(
     }
   }
 
+  // When only OpenAPI specs changed (no MDX changes), revalidate all pages
+  // because we can't know which pages reference the changed spec
+  if (changed.length === 0 && hasOpenapiChanges(oldManifest, newManifest)) {
+    return Object.keys(newManifest.files).map(p => p.replace('.mdx', ''));
+  }
+
   return changed;
 }
 
+/** Check if any OpenAPI spec hashes changed between manifests. */
+function hasOpenapiChanges(oldManifest: Manifest, newManifest: Manifest): boolean {
+  const oldSpecs = oldManifest.openapi || {};
+  const newSpecs = newManifest.openapi || {};
+
+  for (const [path, info] of Object.entries(newSpecs)) {
+    if (!oldSpecs[path] || oldSpecs[path].hash !== info.hash) return true;
+  }
+  for (const path of Object.keys(oldSpecs)) {
+    if (!(path in newSpecs)) return true;
+  }
+  return false;
+}
+
 /** Trigger revalidation for changed files between manifests. */
 export async function triggerRevalidationForChanges(
   projectSlug: string,