nuxt-ai-ready 1.4.0 → 1.5.0

package/README.md

@@ -41,6 +41,8 @@ npx nuxi@latest module add nuxt-ai-ready
 > npx skilld add nuxt-ai-ready
 > ```
 
+💡 Made your site AI-ready? Preview how a page converts to LLM-readable markdown with the free [HTML→Markdown tool](https://nuxtseo.com/tools/html-to-markdown), or track how AI engines index, rank and cite your site with [Nuxt SEO Pro](https://nuxtseo.com/pro).
+
 ## Documentation
 
 [📖 Read the full documentation](https://nuxtseo.com/ai-ready) for more information.

package/dist/module.json

@@ -4,7 +4,7 @@
     "nuxt": ">=4.0.0"
   },
   "configKey": "aiReady",
-  "version": "1.4.0",
+  "version": "1.5.0",
   "builder": {
     "@nuxt/module-builder": "1.0.2",
     "unbuild": "3.6.1"

package/dist/module.mjs

@@ -675,11 +675,13 @@ const module$1 = defineNuxtModule({
       nuxt.options.robots = robotsOpts;
       const groups = robotsOpts.groups || [];
       robotsOpts.groups = groups;
-      groups.push({
+      const group = {
         userAgent: "*",
-        contentUsage: [`train-ai=${config.contentSignal.aiTrain ? "y" : "n"}`],
         contentSignal: [`ai-train=${config.contentSignal.aiTrain ? "yes" : "no"}`, `search=${config.contentSignal.search ? "yes" : "no"}`, `ai-input=${config.contentSignal.aiInput ? "yes" : "no"}`]
-      });
+      };
+      if (config.contentSignal.contentUsage !== false)
+        group.contentUsage = [`train-ai=${config.contentSignal.aiTrain ? "y" : "n"}`];
+      groups.push(group);
     }
     registerTypeTemplates();
     const defaultLlmsTxtSections = [];

package/dist/runtime/server/db/drizzle/providers/libsql.js

@@ -4,9 +4,14 @@ import { useRuntimeConfig } from "nitropack/runtime";
 import * as schema from "#ai-ready-virtual/db-schema.mjs";
 import { logger } from "../../../logger.js";
 import { registerDriver } from "../raw.js";
+import { resolveWritableDbPath } from "./dbPath.js";
 export async function createClient(event) {
   const config = useRuntimeConfig(event)["nuxt-ai-ready"];
-  const dbUrl = config.database.url || `file:${config.database.filename || ".data/ai-ready/pages.db"}`;
+  let dbUrl = config.database.url || `file:${config.database.filename || ".data/ai-ready/pages.db"}`;
+  if (dbUrl.startsWith("file:") && !dbUrl.startsWith("file://")) {
+    const resolved = await resolveWritableDbPath(dbUrl.slice("file:".length));
+    dbUrl = `file:${resolved}`;
+  }
   logger.debug(`[drizzle] Connecting to LibSQL: ${dbUrl}`);
   const client = createLibSQLClient({ url: dbUrl, authToken: config.database.authToken });
   const db = drizzle(client, { schema });

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

@@ -9,14 +9,14 @@ import { buildFrontmatter } from "../utils/frontmatter.js";
 import { computeLocaleAlternates, resolveLocaleFromRoute } from "../utils/i18n.js";
 import { buildLinkHeader } from "../utils/link-header.js";
 const INTERNAL_HEADER = "x-ai-ready-internal";
-function setNegotiationHeaders(event, path, config) {
+function setNegotiationHeaders(event, path, config, resolveUrl) {
   setHeader(event, "vary", "Accept, Sec-Fetch-Dest");
-  setHeader(event, "link", buildLinkHeader(path, "html", config));
+  setHeader(event, "link", buildLinkHeader(path, "html", config, resolveUrl));
 }
-function setMarkdownHeaders(event, path, config) {
+function setMarkdownHeaders(event, path, config, resolveUrl) {
   setHeader(event, "content-type", "text/markdown; charset=utf-8");
   setHeader(event, "vary", "Accept, Sec-Fetch-Dest");
-  setHeader(event, "link", buildLinkHeader(path, "markdown", config));
+  setHeader(event, "link", buildLinkHeader(path, "markdown", config, resolveUrl));
   if (config.markdownCacheHeaders) {
     const { maxAge, swr } = config.markdownCacheHeaders;
     const cacheControl = swr ? `public, max-age=${maxAge}, stale-while-revalidate=${maxAge}` : `public, max-age=${maxAge}`;
@@ -65,9 +65,10 @@ export default defineEventHandler(async (event) => {
   }
   const { path, isExplicit, negotiation } = renderInfo;
   const config = useRuntimeConfig(event)["nuxt-ai-ready"];
-  const canonicalUrl = withSiteUrl(event, path);
+  const resolveUrl = (path2) => withSiteUrl(event, path2);
+  const canonicalUrl = resolveUrl(path);
   if (negotiation === "html") {
-    setNegotiationHeaders(event, path, config);
+    setNegotiationHeaders(event, path, config, resolveUrl);
     return;
   }
   if (!isExplicit) {
@@ -85,7 +86,7 @@ export default defineEventHandler(async (event) => {
       canonical_url: canonicalUrl,
       last_updated: contentPage.updatedAt || (/* @__PURE__ */ new Date()).toISOString()
     });
-    setMarkdownHeaders(event, path, config);
+    setMarkdownHeaders(event, path, config, resolveUrl);
     return `${frontmatter}
 ${contentPage.markdown}`;
   }
@@ -98,7 +99,7 @@ ${contentPage.markdown}`;
     return null;
   });
   if (!response) {
-    setMarkdownHeaders(event, path, config);
+    setMarkdownHeaders(event, path, config, resolveUrl);
     return notFoundMarkdown(canonicalUrl, path, config);
   }
   if (response.status >= 300 && response.status < 400) {
@@ -113,12 +114,12 @@ ${contentPage.markdown}`;
     }
   }
   if (!response.ok) {
-    setMarkdownHeaders(event, path, config);
+    setMarkdownHeaders(event, path, config, resolveUrl);
     return notFoundMarkdown(canonicalUrl, path, config);
   }
   const contentType = response.headers.get("content-type") || "";
   if (!contentType.includes("text/html")) {
-    setMarkdownHeaders(event, path, config);
+    setMarkdownHeaders(event, path, config, resolveUrl);
     return notFoundMarkdown(canonicalUrl, path, config);
   }
   const html = await response.text();
@@ -144,6 +145,6 @@ ${contentPage.markdown}`;
       additionalFrontmatter
     }
   );
-  setMarkdownHeaders(event, path, config);
+  setMarkdownHeaders(event, path, config, resolveUrl);
   return result.markdown;
 });

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

@@ -7,7 +7,9 @@ import type { ModulePublicRuntimeConfig } from '../../../module.js';
  * `encodeURI` preserves `/` separators and other reserved URL characters.
  */
 export declare function encodePathForHeader(path: string): string;
+type LinkUrlResolver = (path: string) => string;
 /**
  * Build a comma-joined Link header value with the standard alternates plus i18n hreflang variants.
  */
-export declare function buildLinkHeader(path: string, variant: 'html' | 'markdown', config: ModulePublicRuntimeConfig): string;
+export declare function buildLinkHeader(path: string, variant: 'html' | 'markdown', config: ModulePublicRuntimeConfig, resolveUrl?: LinkUrlResolver): string;
+export {};

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

@@ -7,7 +7,16 @@ function toMarkdownPath(path) {
     return `${path}index.md`;
   return `${path}.md`;
 }
-export function buildLinkHeader(path, variant, config) {
+function resolveHeaderUrl(path, resolveUrl) {
+  if (!resolveUrl)
+    return path;
+  try {
+    return resolveUrl(path);
+  } catch {
+    return path;
+  }
+}
+export function buildLinkHeader(path, variant, config, resolveUrl) {
   const parts = [];
   if (variant === "html") {
     parts.push(`<${encodePathForHeader(toMarkdownPath(path))}>; rel="alternate"; type="text/markdown"`);
@@ -18,7 +27,7 @@ export function buildLinkHeader(path, variant, config) {
     const alternates = computeLocaleAlternates(path, config.i18n);
     for (const alt of alternates) {
       const href = variant === "markdown" ? toMarkdownPath(alt.path) : alt.path;
-      parts.push(`<${encodePathForHeader(href)}>; rel="alternate"; hreflang="${alt.hreflang}"`);
+      parts.push(`<${encodePathForHeader(resolveHeaderUrl(href, resolveUrl))}>; rel="alternate"; hreflang="${alt.hreflang}"`);
     }
   }
   return parts.join(", ");

package/dist/runtime/types.d.ts

@@ -42,6 +42,12 @@ export interface ModuleOptions {
          * Allow Training or fine-tuning AI models.
          */
         aiTrain?: boolean;
+        /**
+         * Emit the draft Content-Usage robots.txt directive.
+         * Set to false to avoid robots.txt validators that do not support it yet.
+         * @default true
+         */
+        contentUsage?: boolean;
         /**
          * Allow building a search index and providing search results (e.g., returning hyperlinks and short excerpts from your website's contents).
          * Search does not include providing AI-generated search summaries.

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "nuxt-ai-ready",
   "type": "module",
-  "version": "1.4.0",
+  "version": "1.5.0",
   "description": "Best practice AI & LLM discoverability for Nuxt sites.",
   "author": {
     "name": "Harlan Wilton",
@@ -57,56 +57,56 @@
     }
   },
   "dependencies": {
-    "@mdream/js": "^1.3.0",
+    "@mdream/js": "^1.4.1",
     "@nuxt/kit": "^4.4.8",
     "citty": "^0.2.2",
     "consola": "^3.4.2",
     "defu": "^6.1.7",
     "drizzle-orm": "^0.45.2",
-    "mdream": "^1.3.0",
+    "mdream": "^1.4.1",
     "nuxt-site-config": "^4.1.0",
-    "nuxtseo-shared": "^5.2.6",
+    "nuxtseo-shared": "^5.3.0",
     "pathe": "^2.0.3",
     "pkg-types": "^2.3.1",
-    "site-config-stack": "^4.0.8",
+    "site-config-stack": "^4.1.0",
     "ufo": "^1.6.4",
     "uncrypto": "^0.1.3"
   },
   "devDependencies": {
-    "@antfu/eslint-config": "^9.0.0",
-    "@arethetypeswrong/cli": "^0.18.3",
-    "@libsql/client": "^0.17.3",
+    "@antfu/eslint-config": "^9.1.0",
+    "@arethetypeswrong/cli": "^0.18.4",
+    "@libsql/client": "^0.17.4",
     "@nuxt/content": "^3.14.0",
     "@nuxt/module-builder": "^1.0.2",
     "@nuxt/test-utils": "^4.0.3",
     "@nuxtjs/eslint-config-typescript": "^12.1.0",
     "@nuxtjs/mcp-toolkit": "^0.17.2",
-    "@nuxtjs/robots": "^6.0.9",
-    "@nuxtjs/sitemap": "^8.2.0",
+    "@nuxtjs/robots": "^6.1.1",
+    "@nuxtjs/sitemap": "^8.2.1",
     "@types/better-sqlite3": "^7.6.13",
-    "@vitest/coverage-v8": "^4.1.8",
+    "@vitest/coverage-v8": "^4.1.9",
     "@vue/test-utils": "^2.4.11",
     "@vueuse/nuxt": "^14.3.0",
-    "better-sqlite3": "^12.10.0",
+    "better-sqlite3": "^12.11.1",
     "bumpp": "^11.1.0",
-    "eslint": "^10.4.1",
+    "eslint": "^10.5.0",
     "eslint-plugin-harlanzw": "^0.17.0",
     "execa": "^9.6.1",
-    "happy-dom": "^20.10.2",
+    "happy-dom": "^20.10.6",
     "nitropack": "^2.13.4",
     "nuxt": "^4.4.8",
     "nuxt-site-config": "^4.1.0",
-    "nuxtseo-layer-devtools": "^5.2.6",
-    "playwright": "^1.60.0",
-    "playwright-core": "^1.60.0",
+    "nuxtseo-layer-devtools": "^5.3.0",
+    "playwright": "^1.61.1",
+    "playwright-core": "^1.61.1",
     "tinyglobby": "^0.2.17",
     "typescript": "^6.0.3",
     "unbuild": "^3.6.1",
-    "vitest": "^4.1.8",
-    "vue": "^3.5.35",
+    "vitest": "^4.1.9",
+    "vue": "^3.5.38",
     "vue-router": "^5.1.0",
-    "vue-tsc": "^3.3.4",
-    "wrangler": "^4.99.0",
+    "vue-tsc": "^3.3.5",
+    "wrangler": "^4.104.0",
     "zod": "^4.4.3"
   },
   "scripts": {