jamdesk 1.1.90 → 1.1.92

package/vendored/lib/openapi/generator.ts

@@ -5,8 +5,8 @@
  * Supports generating pages from navigation openapi field.
  */
 
-import type { OpenAPI, OpenAPIV3 } from 'openapi-types';
-import type { GeneratedPage, HttpMethod, OpenApiEndpointData } from './types';
+import type { OpenAPIV3 } from 'openapi-types';
+import type { GeneratedPage, OpenApiEndpointData } from './types';
 import { parseEndpoint, getAllEndpoints, getSpecInfo } from './parser';
 import { getCachedSpec } from './cache';
 
@@ -94,7 +94,7 @@ export async function generatePagesFromSpec(
   
   for (const { method, path, operation, tags } of endpoints) {
     // Skip hidden endpoints (x-hidden extension)
-    if ((operation as any)['x-hidden']) {
+    if ((operation as { 'x-hidden'?: unknown })['x-hidden']) {
       continue;
     }
     

package/vendored/lib/openapi/parser.ts

@@ -193,8 +193,9 @@ function parseServers(api: OpenAPI.Document): ServerInfo[] {
   
   // Swagger 2.0
   if ('host' in api && typeof api.host === 'string') {
-    const scheme = (api as any).schemes?.[0] || 'https';
-    const basePath = (api as any).basePath || '';
+    const swagger2 = api as { schemes?: string[]; basePath?: string };
+    const scheme = swagger2.schemes?.[0] || 'https';
+    const basePath = swagger2.basePath || '';
     return [{
       url: `${scheme}://${api.host}${basePath}`,
     }];
@@ -229,9 +230,16 @@ function parseSecuritySchemes(api: OpenAPI.Document): Map<string, SecurityRequir
 
   // Swagger 2.0
   if ('securityDefinitions' in api) {
-    const defs = (api as any).securityDefinitions;
+    type Swagger2SecurityScheme = {
+      type: SecurityRequirement['type'];
+      scheme?: string;
+      in?: SecurityRequirement['in'];
+      name?: string;
+    };
+    const defs = (api as { securityDefinitions?: Record<string, Swagger2SecurityScheme> })
+      .securityDefinitions;
     for (const [name, scheme] of Object.entries(defs || {})) {
-      const s = scheme as any;
+      const s = scheme as Swagger2SecurityScheme;
       schemes.set(name, {
         name,
         type: s.type,
@@ -319,7 +327,7 @@ function parseRequestBody(
     content[mediaType] = {
       schema: toJsonSchema(mediaObj.schema),
       example: mediaObj.example,
-      examples: mediaObj.examples as any,
+      examples: mediaObj.examples as Record<string, { value: unknown; summary?: string }> | undefined,
     };
   }
   
@@ -346,7 +354,7 @@ function parseResponses(
       content[mediaType] = {
         schema: toJsonSchema(mediaObj.schema),
         example: mediaObj.example,
-        examples: mediaObj.examples as any,
+        examples: mediaObj.examples as Record<string, { value: unknown; summary?: string }> | undefined,
       };
     }
     

package/vendored/lib/openapi/validator.ts

@@ -41,12 +41,12 @@ function checkDuplicateOperationIds(
   specPath: string
 ): OpenApiValidationError | null {
   const seen = new Map<string, string>(); // operationId → "METHOD /path"
-  const paths = (api as any).paths || {};
+  const paths = (api as { paths?: Record<string, unknown> }).paths || {};
   const methods = ['get', 'post', 'put', 'patch', 'delete', 'head', 'options'];
 
   for (const [pathStr, pathItem] of Object.entries(paths)) {
     for (const method of methods) {
-      const operation = (pathItem as Record<string, any>)?.[method];
+      const operation = (pathItem as Record<string, { operationId?: string } | undefined> | undefined)?.[method];
       if (!operation?.operationId) continue;
 
       const id = operation.operationId;

package/vendored/lib/openapi-isr.ts

@@ -69,7 +69,10 @@ export async function fetchOpenApiSpecFromR2(
   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)
+  // Dereference all $ref pointers (matching static mode's SwaggerParser.validate behavior).
+  // SwaggerParser.dereference accepts a loose Document type that does not line up with
+  // our internal OpenApiSpec; intermediate `any` cast is required at this library boundary.
+  // eslint-disable-next-line @typescript-eslint/no-explicit-any -- SwaggerParser type interop (see CLAUDE.md memory)
   const spec = await SwaggerParser.dereference(raw as any) as unknown as OpenApiSpec;
 
   // Cache it

package/vendored/lib/public-paths-resolver.ts

@@ -22,10 +22,11 @@ function collectPublicGroupPages(
   if (!nav || typeof nav !== 'object') return out;
 
   const node = nav as Record<string, unknown>;
+  const pages = node.pages;
 
-  if ('group' in node && Array.isArray((node as any).pages)) {
+  if ('group' in node && Array.isArray(pages)) {
     const isPublic = inPublicGroup || node.public === true;
-    for (const p of (node as any).pages) {
+    for (const p of pages) {
       if (typeof p === 'string') {
         if (isPublic) out.push(`/${p}`);
       } else {
@@ -35,14 +36,14 @@ function collectPublicGroupPages(
     return out;
   }
 
-  if (Array.isArray((node as any).pages)) {
-    for (const p of (node as any).pages) {
+  if (Array.isArray(pages)) {
+    for (const p of pages) {
       collectPublicGroupPages(p, inPublicGroup, out);
     }
   }
 
   for (const key of ['groups', 'tabs', 'anchors', 'versions', 'languages']) {
-    const arr = (node as any)[key];
+    const arr = node[key];
     if (Array.isArray(arr)) {
       for (const item of arr) {
         collectPublicGroupPages(item, inPublicGroup, out);
@@ -72,7 +73,7 @@ export function resolvePublicPaths(input: Input): string[] {
     set.add(path);
   }
 
-  const globs = (input.docsConfig as any).auth?.password?.public;
+  const globs = input.docsConfig.auth?.password?.public;
   if (Array.isArray(globs)) {
     for (const g of globs) {
       if (typeof g === 'string' && g.startsWith('/')) {

package/vendored/lib/redis.ts

@@ -44,9 +44,9 @@ async function upstashCommand(
     headers: { Authorization: `Bearer ${kvToken}` },
   });
   const bodyText = await response.text();
-  let data: any = null;
+  let data: { error?: string; result?: unknown } | null = null;
   try {
-    data = bodyText ? JSON.parse(bodyText) : null;
+    data = bodyText ? (JSON.parse(bodyText) as { error?: string; result?: unknown }) : null;
   } catch {
     data = { result: bodyText };
   }

package/vendored/lib/rehype-code-meta.ts

@@ -154,7 +154,7 @@ export function rehypeCodeMeta() {
 
         // Store parsed data in node.data so Shiki transformers can access it
         node.data = node.data || {};
-        (node.data as any).parsedMeta = parsed;
+        (node.data as { parsedMeta?: unknown }).parsedMeta = parsed;
 
         if (parsed.icon) {
           node.properties['data-icon'] = parsed.icon;
@@ -182,7 +182,7 @@ export function rehypeCodeMeta() {
           preNode.properties['data-title'] = parsed.title;
           // Store in parent data as well
           preNode.data = preNode.data || {};
-          (preNode.data as any).parsedTitle = parsed.title;
+          (preNode.data as { parsedTitle?: string }).parsedTitle = parsed.title;
         }
       }
     });

package/vendored/lib/render-doc-page.tsx

@@ -13,7 +13,7 @@
 import { notFound } from 'next/navigation';
 import { MDXRemote } from 'next-mdx-remote/rsc';
 import type { Metadata } from 'next';
-import type { ReactElement } from 'react';
+import type { AnchorHTMLAttributes, ReactElement } from 'react';
 import { MDXComponents } from '@/components/mdx/MDXComponents';
 import { Breadcrumb } from '@/components/navigation/Breadcrumb';
 import { TableOfContents } from '@/components/navigation/TableOfContents';
@@ -360,7 +360,7 @@ export async function renderDocPage(input: RenderInput): Promise<ReactElement> {
     ...snippetAliases,
     ...inlineComponents,
     ...(hostAtDocs ? {
-      a: ({ ariaLabel, href, ...props }: any) => {
+      a: ({ ariaLabel, href, ...props }: AnchorHTMLAttributes<HTMLAnchorElement> & { ariaLabel?: string }) => {
         const needsPrefix = href?.startsWith('/') && !href.startsWith('/docs/') && href !== '/docs';
         return (
           <a

package/vendored/lib/seo.ts

@@ -8,9 +8,14 @@
  */
 
 import type { Metadata } from 'next';
-import type { DocsConfig, Logo, LogoConfig, Favicon, FaviconConfig, LanguageConfig, LanguageCode } from './docs-types';
+import type { DocsConfig, Logo, LogoConfig, Favicon, LanguageConfig, LanguageCode } from './docs-types';
 import { transformConfigImagePath } from './docs-types';
-import { transformLanguagePath, extractLanguageFromPath, isValidLanguageCode } from './language-utils';
+import { findHreflangAliasCollisions, transformLanguagePath, toHreflang } from './language-utils';
+import { logger } from '../shared/logger';
+
+// Dedupe per-process: same docs.json shape produces the same collision
+// signature on every page render, so we'd otherwise spam logs.
+const warnedCollisionSignatures = new Set<string>();
 
 const HAS_DOCS_SUFFIX = /\b(?:Documentation|Docs)\s*$/i;
 
@@ -183,7 +188,7 @@ function getLanguagePagePaths(langConfig: LanguageConfig): Set<string> {
  * @param languages - Array of language configurations from docs.json
  * @returns Record of language code to URL for alternates.languages
  */
-function buildHreflangAlternates(
+export function buildHreflangAlternates(
   baseUrl: string,
   pagePath: string,
   languages: LanguageConfig[]
@@ -197,14 +202,12 @@ function buildHreflangAlternates(
   const defaultLang = languages.find((l) => l.default)?.language || languages[0]?.language || 'en';
 
   // Detect current language from path
-  const currentLang = extractLanguageFromPath(pagePath) || defaultLang;
-
   // Keep only languages whose navigation declares this page — capturing the
   // language-relative path so the build loop and x-default branch don't have
   // to recompute it via transformLanguagePath.
   const supported: Array<{ lang: LanguageCode; cleanPath: string }> = [];
   for (const langConfig of languages) {
-    const langPath = transformLanguagePath(pagePath, currentLang, langConfig.language, defaultLang);
+    const langPath = transformLanguagePath(pagePath, langConfig.language, defaultLang);
     const cleanPath = langPath.replace(/^\//, '');
     if (getLanguagePagePaths(langConfig).has(cleanPath)) {
       supported.push({ lang: langConfig.language, cleanPath });
@@ -217,9 +220,21 @@ function buildHreflangAlternates(
     return undefined;
   }
 
+  const collisions = findHreflangAliasCollisions(supported.map((s) => s.lang));
+  for (const { tag, codes } of collisions) {
+    const signature = `${tag}:${codes.join(',')}`;
+    if (warnedCollisionSignatures.has(signature)) continue;
+    warnedCollisionSignatures.add(signature);
+    logger.warn('hreflang alias collision — last entry wins, earlier translations dropped', {
+      bcp47Tag: tag,
+      internalCodes: codes,
+      remedy: 'Remove one of the duplicate entries from navigation.languages in docs.json',
+    });
+  }
+
   const alternates: Record<string, string> = {};
   for (const { lang, cleanPath } of supported) {
-    alternates[lang] = cleanPath ? `${baseUrl}/${cleanPath}` : baseUrl;
+    alternates[toHreflang(lang)] = cleanPath ? `${baseUrl}/${cleanPath}` : baseUrl;
   }
 
   // x-default points to the default language only when it has the page; absence

package/vendored/lib/shiki-highlighter.ts

@@ -8,7 +8,7 @@ import { PRELOADED_LANGUAGES, SUPPORTED_THEMES, type SupportedTheme } from './sh
 
 // Extend globalThis type for highlighter caching
 declare global {
-  // eslint-disable-next-line no-var
+
   var __shikiHighlighterPromise: Promise<Highlighter> | undefined;
 }
 

package/vendored/lib/snippet-loader-isr.ts

@@ -322,7 +322,7 @@ async function compileSnippet(
     try {
       // Create function that returns the component
       // NOTE: new Function() is intentionally used here to compile user-provided snippets
-      // eslint-disable-next-line @typescript-eslint/no-implied-eval
+
       const createComponent = new Function(
         'React',
         '_jsx',

package/vendored/lib/static-artifacts.ts

@@ -5,7 +5,7 @@
  * for ISR projects. These are uploaded to R2 alongside the MDX content.
  */
 
-import type { NavigationConfig } from './docs-types.js';
+import type { NavigationConfig, LanguageConfig } from './docs-types.js';
 import { RECURSE_KEYS } from './enhance-navigation.js';
 import { filterVisibility } from './visibility-filter.js';
 import {
@@ -13,6 +13,7 @@ import {
   resolveLocaleFromPath,
   resolveLocaleWithLoweredSet,
 } from './language-utils.js';
+import { buildHreflangAlternates } from './seo.js';
 
 /**
  * Page metadata for artifact generation.
@@ -44,6 +45,13 @@ export interface SitemapOptions {
   hostAtDocs?: boolean;
   /** Block all crawlers - generates empty sitemap */
   noindex?: boolean;
+  /**
+   * Language configurations from docs.json navigation. When provided, the
+   * sitemap emits `<xhtml:link rel="alternate" hreflang>` siblings per URL
+   * for every language that declares the page — Google's recommended sitemap
+   * localization signal (in addition to in-page hreflang link tags).
+   */
+  languages?: LanguageConfig[];
 }
 
 /**
@@ -53,7 +61,7 @@ export interface SitemapOptions {
  * @returns XML string
  */
 export function generateSitemap(options: SitemapOptions): string {
-  const { baseUrl, pages, hostAtDocs = false, noindex = false } = options;
+  const { baseUrl, pages, hostAtDocs = false, noindex = false, languages } = options;
 
   if (noindex) {
     return `<?xml version="1.0" encoding="UTF-8"?>
@@ -62,6 +70,11 @@ export function generateSitemap(options: SitemapOptions): string {
   }
 
   const urlPrefix = hostAtDocs ? '/docs' : '';
+  const hreflangBaseUrl = hostAtDocs ? `${baseUrl}/docs` : baseUrl;
+  const multiLang = languages && languages.length > 1;
+  const urlsetAttrs = multiLang
+    ? 'xmlns="http://www.sitemaps.org/schemas/sitemap/0.9" xmlns:xhtml="http://www.w3.org/1999/xhtml"'
+    : 'xmlns="http://www.sitemaps.org/schemas/sitemap/0.9"';
 
   const entries = pages
     .filter(p => !p.noindex && !p.hidden)
@@ -70,16 +83,32 @@ export function generateSitemap(options: SitemapOptions): string {
       const lastmod = p.lastModified || new Date().toISOString().split('T')[0];
       const priority = p.path === 'introduction' ? '1.0' : '0.8';
 
+      // Per Google's spec, emit hreflang siblings only when the page has
+      // translations. buildHreflangAlternates already filters to languages
+      // whose navigation declares this page, so we won't point at 404s.
+      let hreflangLinks = '';
+      if (multiLang) {
+        const alternates = buildHreflangAlternates(hreflangBaseUrl, p.path, languages);
+        if (alternates) {
+          hreflangLinks = Object.entries(alternates)
+            .map(
+              ([tag, href]) =>
+                `\n    <xhtml:link rel="alternate" hreflang="${tag}" href="${href}"/>`,
+            )
+            .join('');
+        }
+      }
+
       return `  <url>
     <loc>${url}</loc>
     <lastmod>${lastmod}</lastmod>
     <changefreq>weekly</changefreq>
-    <priority>${priority}</priority>
+    <priority>${priority}</priority>${hreflangLinks}
   </url>`;
     });
 
   return `<?xml version="1.0" encoding="UTF-8"?>
-<urlset xmlns="http://www.sitemaps.org/schemas/sitemap/0.9">
+<urlset ${urlsetAttrs}>
 ${entries.join('\n')}
 </urlset>`;
 }
@@ -353,6 +382,8 @@ export interface GenerateAllOptions {
   rssPages?: RssPageInfo[];
   /** Pages with full content (for llms-full.txt generation) */
   llmsFullPages?: LlmsFullPageInfo[];
+  /** Language configurations (forwarded to sitemap for hreflang siblings) */
+  languages?: LanguageConfig[];
 }
 
 /**
@@ -374,10 +405,10 @@ export interface GeneratedArtifacts {
  */
 export function generateAllArtifacts(options: GenerateAllOptions): GeneratedArtifacts {
   const {
-    baseUrl, name, description, pages, hostAtDocs, noindex, rssPages, llmsFullPages,
+    baseUrl, name, description, pages, hostAtDocs, noindex, rssPages, llmsFullPages, languages,
   } = options;
 
-  const sitemap = generateSitemap({ baseUrl, pages, hostAtDocs, noindex });
+  const sitemap = generateSitemap({ baseUrl, pages, hostAtDocs, noindex, languages });
   const llmsTxt = generateLlmsTxt({
     name, description, baseUrl, pages, hostAtDocs, noindex,
   });

package/vendored/lib/validate-config.ts

@@ -12,6 +12,7 @@
 import AjvModule, { ErrorObject } from 'ajv';
 import addFormatsModule from 'ajv-formats';
 // ESM compatibility - ajv-formats exports differently under NodeNext resolution
+// eslint-disable-next-line @typescript-eslint/no-explicit-any -- ajv-formats ESM/CJS interop default-export shape varies by bundler
 const addFormats = (addFormatsModule as any).default || addFormatsModule;
 // ESM compatibility - Ajv exports differently in Node.js ESM
 // eslint-disable-next-line @typescript-eslint/no-explicit-any

package/vendored/workspace-package-lock.json

@@ -1921,12 +1921,12 @@
       }
     },
     "node_modules/@types/node": {
-      "version": "25.7.0",
-      "resolved": "https://registry.npmjs.org/@types/node/-/node-25.7.0.tgz",
-      "integrity": "sha512-z+pdZyxE+RTQE9AcboAZCb4otwcrvgHD+GlBpPgn0emDVt0ohrTMhAwlr2Wd9nZ+nihhYFxO2pThz3C5qSu2Eg==",
+      "version": "25.8.0",
+      "resolved": "https://registry.npmjs.org/@types/node/-/node-25.8.0.tgz",
+      "integrity": "sha512-TCFSk8IZh+iLX1xtksoBVtdmgL+1IX0fC9BeU4QqFSuNdN/K+HUlhqOzEmSYYpZUVsLYcPqc9KX+60iDuninSQ==",
       "license": "MIT",
       "dependencies": {
-        "undici-types": "~7.21.0"
+        "undici-types": ">=7.24.0 <7.24.7"
       }
     },
     "node_modules/@types/react": {
@@ -2928,9 +2928,9 @@
       "license": "MIT"
     },
     "node_modules/electron-to-chromium": {
-      "version": "1.5.354",
-      "resolved": "https://registry.npmjs.org/electron-to-chromium/-/electron-to-chromium-1.5.354.tgz",
-      "integrity": "sha512-JaBHwWcfIdmSAfWM5l3uwjGd431j8YEMikZ+K/2nXVuBqJKyZ0f+2h4n4JY5AyNiZmnY9qQr2RU3v9DxDmHMNg==",
+      "version": "1.5.355",
+      "resolved": "https://registry.npmjs.org/electron-to-chromium/-/electron-to-chromium-1.5.355.tgz",
+      "integrity": "sha512-LUPZhKzZPYSPme1jEYohpkA+ybYCJztr1quAdBd7E7h3+VOBVcKkwwtBJu41nrjawrRzfb8mtMfzWozoaK0ZIQ==",
       "license": "ISC"
     },
     "node_modules/enhanced-resolve": {
@@ -6279,9 +6279,9 @@
       "license": "MIT"
     },
     "node_modules/undici-types": {
-      "version": "7.21.0",
-      "resolved": "https://registry.npmjs.org/undici-types/-/undici-types-7.21.0.tgz",
-      "integrity": "sha512-w9IMgQrz4O0YN1LtB7K5P63vhlIOvC7opSmouCJ+ZywlPAlO9gIkJ+otk6LvGpAs2wg4econaCz3TvQ9xPoyuQ==",
+      "version": "7.24.6",
+      "resolved": "https://registry.npmjs.org/undici-types/-/undici-types-7.24.6.tgz",
+      "integrity": "sha512-WRNW+sJgj5OBN4/0JpHFqtqzhpbnV0GuB+OozA9gCL7a993SmU+1JBZCzLNxYsbMfIeDL+lTsphD5jN5N+n0zg==",
       "license": "MIT"
     },
     "node_modules/unified": {