nuxt-ai-ready 1.7.10 → 1.7.12

package/dist/chunks/agent-skills.mjs

@@ -2,7 +2,7 @@ import { createHash } from 'node:crypto';
 import { realpath, readFile } from 'node:fs/promises';
 import { resolve, isAbsolute, relative, sep } from 'node:path';
 import { parseDocument } from 'yaml';
-import { A as AGENT_SKILLS_SCHEMA } from '../shared/nuxt-ai-ready.jeGqwuW1.mjs';
+import { A as AGENT_SKILLS_SCHEMA } from '../shared/nuxt-ai-ready.Cp2hOQih.mjs';
 import 'node:module';
 import '@nuxt/kit';
 import 'defu';

package/dist/chunks/prerender.mjs

@@ -5,7 +5,7 @@ import { colorize } from 'consola/utils';
 import { resolveLocaleFromRoute } from 'nuxtseo-shared/i18n-runtime';
 import { collectSitemap } from 'sitemapd/parse';
 import { withLeadingSlash, withBase, joinURL } from 'ufo';
-import { l as logger, M as MARKDOWN_LINK_AVAILABILITY_FILE } from '../shared/nuxt-ai-ready.jeGqwuW1.mjs';
+import { l as logger, M as MARKDOWN_LINK_AVAILABILITY_FILE } from '../shared/nuxt-ai-ready.Cp2hOQih.mjs';
 import { normalizePagePath, toMarkdownPath } from '../../dist/runtime/markdown-path.js';
 import { toLogicalRoute, toDeployedRoute } from '../../dist/runtime/route-path.js';
 import { initSchema, computeContentHash, insertPage, queryAllPages, exportDbDump } from '../../dist/runtime/server/db/shared.js';

package/dist/module.json

@@ -4,7 +4,7 @@
     "nuxt": ">=4.0.0"
   },
   "configKey": "aiReady",
-  "version": "1.7.10",
+  "version": "1.7.12",
   "builder": {
     "@nuxt/module-builder": "1.0.3",
     "unbuild": "3.6.1"

package/dist/module.mjs

@@ -7,7 +7,7 @@ import 'defu';
 import 'nuxt-site-config/kit';
 import 'nuxtseo-shared/kit';
 import 'pkg-types';
-export { m as default } from './shared/nuxt-ai-ready.jeGqwuW1.mjs';
+export { m as default } from './shared/nuxt-ai-ready.Cp2hOQih.mjs';
 import '../dist/runtime/server/utils/discovery-response.js';
 import 'node:url';
 import 'pathe';

package/dist/runtime/server/db/drizzle/queries.js

@@ -11,8 +11,13 @@ function resolveFtsTokenizer(event) {
 }
 const RE_LEADING_SLASH = /^\//;
 const RE_SLASH = /\//g;
+function normalizeRoute(route) {
+  if (!route || route === "/")
+    return "/";
+  return route.startsWith("/") ? route : `/${route}`;
+}
 function normalizeRouteKey(route) {
-  return route.replace(RE_LEADING_SLASH, "").replace(RE_SLASH, ":") || "index";
+  return normalizeRoute(route).replace(RE_LEADING_SLASH, "").replace(RE_SLASH, ":") || "index";
 }
 function rowToPage(row) {
   return {
@@ -42,7 +47,7 @@ export async function upsertPage(event, page) {
   const client = await useDrizzle(event);
   const now = Date.now();
   const values = {
-    route: page.route,
+    route: normalizeRoute(page.route),
     routeKey: normalizeRouteKey(page.route),
     title: page.title,
     description: page.description,
@@ -700,8 +705,10 @@ export async function seedRoutes(event, routes) {
   if (routes.length === 0)
     return 0;
   const byRoute = /* @__PURE__ */ new Map();
-  for (const route of routes)
+  for (const raw of routes) {
+    const route = normalizeRoute(raw);
     byRoute.set(route, normalizeRouteKey(route));
+  }
   const ROWS_PER_INSERT = 20;
   const db = await useRawDb(event);
   const now = (/* @__PURE__ */ new Date()).toISOString();

package/dist/runtime/server/db/queries.js

@@ -4,7 +4,7 @@ import { resolveLocaleFromRoute } from "../utils/i18n.js";
 import { parseSitemapCrawlState, serializeSitemapCrawlState } from "../utils/sitemap-crawl-state.js";
 import { initSchema } from "./drizzle/queries.js";
 import { useRawDb } from "./drizzle/raw.js";
-import { normalizeRouteKey } from "./shared.js";
+import { normalizeRoute, normalizeRouteKey } from "./shared.js";
 function deriveLocale(event, route, explicit) {
   if (explicit !== void 0)
     return explicit;
@@ -261,12 +261,13 @@ export async function upsertPage(event, page) {
   const db = await getDb(event);
   if (!db)
     return;
-  const routeKey = normalizeRouteKey(page.route);
+  const route = normalizeRoute(page.route);
+  const routeKey = normalizeRouteKey(route);
   const keywordsJson = JSON.stringify(page.keywords);
   const indexedAt = Date.now();
   const source = page.source || "runtime";
   const lastSeenAt = source === "runtime" ? indexedAt : null;
-  const locale = deriveLocale(event, page.route, page.locale);
+  const locale = deriveLocale(event, route, page.locale);
   await db.exec(`
     INSERT INTO ai_ready_pages (route, route_key, title, description, markdown, headings, keywords, content_hash, updated_at, indexed_at, is_error, indexed, source, last_seen_at, locale)
     VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, 1, ?, ?, ?)
@@ -284,7 +285,7 @@ export async function upsertPage(event, page) {
       source = excluded.source,
       last_seen_at = excluded.last_seen_at,
       locale = excluded.locale
-  `, [page.route, routeKey, page.title, page.description, page.markdown, page.headings, keywordsJson, page.contentHash || null, page.updatedAt, indexedAt, page.isError ? 1 : 0, source, lastSeenAt, locale]);
+  `, [route, routeKey, page.title, page.description, page.markdown, page.headings, keywordsJson, page.contentHash || null, page.updatedAt, indexedAt, page.isError ? 1 : 0, source, lastSeenAt, locale]);
 }
 export async function isPageFresh(event, route, ttlSeconds) {
   if (ttlSeconds <= 0)
@@ -323,7 +324,7 @@ export async function seedRoutes(event, routes) {
   const nowMs = Date.now();
   const byRoute = /* @__PURE__ */ new Map();
   for (const entry of routes) {
-    const route = typeof entry === "string" ? entry : entry.route;
+    const route = normalizeRoute(typeof entry === "string" ? entry : entry.route);
     const explicitLocale = typeof entry === "string" ? void 0 : entry.locale;
     byRoute.set(route, {
       route,

package/dist/runtime/server/db/shared.d.ts

@@ -27,9 +27,29 @@ export interface InitSchemaOptions {
  * a CJK locale on a later deploy).
  */
 export declare function initSchema(db: DatabaseAdapter, options?: InitSchemaOptions): Promise<void>;
+/**
+ * Canonical storage form of a route.
+ *
+ * `ai_ready_pages` puts a UNIQUE index on `route` and another on `route_key`,
+ * while every upsert targets `ON CONFLICT(route)`. Two spellings of one page
+ * therefore have to agree on `route`, or the conflict target misses, the insert
+ * reaches the `route_key` index instead, and the whole statement fails with
+ * `UNIQUE constraint failed: ai_ready_pages.route_key`.
+ *
+ * `''` and `'/'` are the pair that occurs in practice, since both key to
+ * `index`: one spelling takes the row, the other retries and fails on every
+ * subsequent write. A bare `'about'` against `'/about'` is the same defect.
+ *
+ * Normalising here rather than widening the conflict target keeps one page to
+ * one row. Widening it would let both spellings persist and race for the key.
+ */
+export declare function normalizeRoute(route: string): string;
 /**
  * Normalize route to storage key format
  * e.g., '/about/team' -> 'about:team', '/' -> 'index'
+ *
+ * Derived from the canonical route so the two can never disagree: equal keys
+ * imply equal routes, which is what the pair of unique indexes requires.
  */
 export declare function normalizeRouteKey(route: string): string;
 /**

package/dist/runtime/server/db/shared.js

@@ -52,8 +52,13 @@ async function getStoredTokenizer(db) {
 }
 const RE_LEADING_SLASH = /^\//;
 const RE_SLASH = /\//g;
+export function normalizeRoute(route) {
+  if (!route || route === "/")
+    return "/";
+  return route.startsWith("/") ? route : `/${route}`;
+}
 export function normalizeRouteKey(route) {
-  return route.replace(RE_LEADING_SLASH, "").replace(RE_SLASH, ":") || "index";
+  return normalizeRoute(route).replace(RE_LEADING_SLASH, "").replace(RE_SLASH, ":") || "index";
 }
 export async function compressToBase64(data) {
   const json = JSON.stringify(data);
@@ -172,9 +177,15 @@ const IMPORT_ROWS_PER_STATEMENT = 5;
 export async function importDbDump(db, rows) {
   if (rows.length === 0)
     return;
+  const byRoute = /* @__PURE__ */ new Map();
+  for (const row of rows) {
+    const route = normalizeRoute(row.route);
+    byRoute.set(route, { ...row, route, route_key: normalizeRouteKey(route) });
+  }
+  const canonical = [...byRoute.values()];
   const stmts = [];
-  for (let i = 0; i < rows.length; i += IMPORT_ROWS_PER_STATEMENT) {
-    const batch = rows.slice(i, i + IMPORT_ROWS_PER_STATEMENT);
+  for (let i = 0; i < canonical.length; i += IMPORT_ROWS_PER_STATEMENT) {
+    const batch = canonical.slice(i, i + IMPORT_ROWS_PER_STATEMENT);
     const valuesSql = batch.map(() => `(?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, 1, ?, ?, ?, ?)`).join(", ");
     const params = batch.flatMap((row) => {
       const source = row.source || "prerender";

package/dist/runtime/server/middleware/markdown.js

@@ -5,14 +5,31 @@ import { withSiteUrl } from "#site-config/server/composables/utils";
 import { toMarkdownPath } from "../../markdown-path.js";
 import { toDeployedRoute } from "../../route-path.js";
 import { logger } from "../logger.js";
+import { setStatusAwareLinkHeader } from "../plugins/link-header.js";
 import { CONTENT_NEGOTIATION_VARY, resolveContentNegotiation } from "../utils/content-negotiation.js";
 import { computeLocaleAlternates, resolveLocaleAlternateUrl, resolveLocaleFromRoute } from "../utils/i18n.js";
 import { buildLinkHeader } from "../utils/link-header.js";
 import { getMarkdownRenderInfo } from "../utils/markdown-request.js";
 const INTERNAL_HEADER = "x-ai-ready-internal";
+function setLinkHeader(event, path, variant, config, resolveUrl, routeContext) {
+  setHeader(event, "link", buildLinkHeader(path, variant, config, resolveUrl, routeContext));
+}
+function setStatusAwareHeader(event, path, variant, config, resolveUrl, routeContext) {
+  const successHeader = buildLinkHeader(path, variant, config, resolveUrl, routeContext);
+  if (!config.i18n) {
+    setHeader(event, "link", successHeader);
+    return;
+  }
+  const safeHeader = buildLinkHeader(path, variant, { ...config, i18n: null }, resolveUrl, routeContext);
+  setStatusAwareLinkHeader(event, safeHeader, successHeader);
+}
 function setNegotiationHeaders(event, path, config, resolveUrl, routeContext) {
   appendHeader(event, "vary", CONTENT_NEGOTIATION_VARY);
-  setHeader(event, "link", buildLinkHeader(path, "html", config, resolveUrl, routeContext));
+  setLinkHeader(event, path, "html", config, resolveUrl, routeContext);
+}
+function setStatusAwareNegotiationHeaders(event, path, config, resolveUrl, routeContext) {
+  appendHeader(event, "vary", CONTENT_NEGOTIATION_VARY);
+  setStatusAwareHeader(event, path, "html", config, resolveUrl, routeContext);
 }
 function setUncacheableHeaders(event) {
   setHeader(event, "cache-control", "private, no-store");
@@ -29,7 +46,7 @@ function setUncacheableHeaders(event) {
 }
 function setMarkdownHeaders(event, path, config, resolveUrl, routeContext) {
   setHeader(event, "content-type", "text/markdown; charset=utf-8");
-  setHeader(event, "link", buildLinkHeader(path, "markdown", config, resolveUrl, routeContext));
+  setLinkHeader(event, path, "markdown", config, resolveUrl, routeContext);
   if (config.markdownCacheHeaders) {
     const { maxAge, swr } = config.markdownCacheHeaders;
     const cacheControl = swr ? `public, max-age=${maxAge}, stale-while-revalidate=${maxAge}` : `public, max-age=${maxAge}`;
@@ -100,9 +117,9 @@ export default defineEventHandler(async (event) => {
   const canonicalUrl = resolveUrl(path);
   if (negotiation === "html") {
     if (contentNegotiation._tag === "enabled")
-      setNegotiationHeaders(event, path, config, resolveUrl, routeContext);
+      setStatusAwareNegotiationHeaders(event, path, config, resolveUrl, routeContext);
     else
-      setHeader(event, "link", buildLinkHeader(path, "html", config, resolveUrl, routeContext));
+      setStatusAwareHeader(event, path, "html", config, resolveUrl, routeContext);
     return;
   }
   if (!isExplicit) {

package/dist/runtime/server/plugins/link-header.d.ts

@@ -0,0 +1,4 @@
+import type { H3Event } from '#nuxtseo/h3';
+export declare function setStatusAwareLinkHeader(event: H3Event, safeHeader: string, successHeader?: string): void;
+declare const _default: any;
+export default _default;

package/dist/runtime/server/plugins/link-header.js

@@ -0,0 +1,40 @@
+import { getHeader, getResponseStatus, setHeader } from "#nuxtseo/h3";
+import { defineNitroPlugin } from "#nuxtseo/nitro";
+const STATUS_AWARE_LINK_HEADER = "nuxt-ai-ready:status-aware-link-header";
+const ERROR_LINK_HEADER = "x-nuxt-ai-ready-error-link";
+export function setStatusAwareLinkHeader(event, safeHeader, successHeader) {
+  event.context[STATUS_AWARE_LINK_HEADER] = {
+    error: safeHeader,
+    success: successHeader ?? safeHeader
+  };
+  setHeader(event, "link", safeHeader);
+}
+export default defineNitroPlugin((nitro) => {
+  nitro.hooks.hook("error", (_error, { event }) => {
+    if (!event)
+      return;
+    const header = event.context[STATUS_AWARE_LINK_HEADER];
+    if (header)
+      event.node.req.headers[ERROR_LINK_HEADER] = header.error;
+  });
+  nitro.hooks.hook("beforeResponse", (event) => {
+    const header = event.context[STATUS_AWARE_LINK_HEADER];
+    if (!header)
+      return;
+    setHeader(event, "link", getResponseStatus(event) >= 400 ? header.error : header.success);
+  });
+  nitro.hooks.hook("render:response", (response, { event }) => {
+    const header = event.context[STATUS_AWARE_LINK_HEADER];
+    const errorHeader = event.path.startsWith("/__nuxt_error") && getHeader(event, "x-nuxt-error") === "true" ? getHeader(event, ERROR_LINK_HEADER) : void 0;
+    if (errorHeader) {
+      response.headers ||= {};
+      response.headers.link = errorHeader;
+      return;
+    }
+    if (!header)
+      return;
+    response.headers ||= {};
+    const statusCode = response.statusCode ?? getResponseStatus(event);
+    response.headers.link = statusCode >= 400 ? header.error : header.success;
+  });
+});

package/dist/shared/{nuxt-ai-ready.jeGqwuW1.mjs → nuxt-ai-ready.Cp2hOQih.mjs}

@@ -480,11 +480,16 @@ function collectPagePaths(routes, parentPath = "") {
     return paths;
   }, /* @__PURE__ */ new Map());
 }
+function isUnlocalizedLocalePage(page) {
+  return page?._tag === "unlocalized" && typeof page.path === "string";
+}
 function materializeI18nPages(i18n, routes) {
   if (!i18n.pages)
     return void 0;
   const pagePaths = collectPagePaths(routes);
   return Object.fromEntries(Object.entries(i18n.pages).map(([pageName, pageLocales]) => {
+    if (isUnlocalizedLocalePage(pageLocales))
+      return [pageName, pageLocales];
     const defaultPath = pageLocales?.[i18n.defaultLocale];
     const fallbackPath = typeof defaultPath === "string" ? defaultPath : pagePaths.get(pageName);
     const locales = Object.fromEntries(i18n.locales.flatMap((locale) => {
@@ -1471,6 +1476,7 @@ export async function lookupContentPage(event, path) {
       middleware: true,
       handler: resolve("./runtime/server/middleware/markdown")
     });
+    addServerPlugin(resolve("./runtime/server/plugins/link-header"));
     addPlugin({
       mode: "server",
       src: resolve("./runtime/app/plugins/md-alternate.server")

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "nuxt-ai-ready",
   "type": "module",
-  "version": "1.7.10",
+  "version": "1.7.12",
   "description": "Best practice AI & LLM discoverability for Nuxt sites.",
   "author": {
     "name": "Harlan Wilton",
@@ -62,18 +62,18 @@
     }
   },
   "dependencies": {
-    "@mdream/js": "^1.5.12",
+    "@mdream/js": "^1.6.2",
     "@nuxt/kit": "^4.5.2",
     "citty": "^0.2.2",
     "consola": "^3.4.2",
     "defu": "^6.1.7",
     "drizzle-orm": "^0.45.2",
-    "mdream": "^1.5.12",
-    "nuxt-site-config": "^4.2.0",
-    "nuxtseo-shared": "^5.3.11",
+    "mdream": "^1.6.2",
+    "nuxt-site-config": "^4.2.2",
+    "nuxtseo-shared": "^5.3.12",
     "pathe": "^2.0.3",
     "pkg-types": "^2.3.1",
-    "site-config-stack": "^4.2.0",
+    "site-config-stack": "^4.2.2",
     "sitemapd": "^0.2.2",
     "ufo": "^1.6.4",
     "uncrypto": "^0.1.3",
@@ -89,7 +89,7 @@
     "@nuxtjs/eslint-config-typescript": "^12.1.0",
     "@nuxtjs/mcp-toolkit": "^0.18.1",
     "@nuxtjs/robots": "^6.1.4",
-    "@nuxtjs/sitemap": "^8.3.3",
+    "@nuxtjs/sitemap": "^8.3.4",
     "@types/better-sqlite3": "^9.6.0",
     "@vitest/coverage-v8": "^4.1.10",
     "@vue/test-utils": "^2.4.11",
@@ -103,8 +103,8 @@
     "happy-dom": "^20.11.2",
     "nitropack": "^2.13.4",
     "nuxt": "^4.5.2",
-    "nuxt-site-config": "^4.2.0",
-    "nuxtseo-layer-devtools": "^5.3.11",
+    "nuxt-site-config": "^4.2.2",
+    "nuxtseo-layer-devtools": "^5.3.12",
     "playwright": "^1.62.1",
     "playwright-core": "^1.62.1",
     "tinyglobby": "^0.2.17",
@@ -114,7 +114,7 @@
     "vue": "^3.5.41",
     "vue-router": "^5.2.0",
     "vue-tsc": "^3.3.9",
-    "wrangler": "^4.120.0",
+    "wrangler": "^4.121.0",
     "zod": "^4.4.3"
   },
   "scripts": {