nuxt-ai-ready 2.4.0 → 2.4.1

package/dist/chunks/agent-skills.mjs

@@ -2,7 +2,7 @@ import { createHash } from 'node:crypto';
 import { realpath, readFile, readdir } from 'node:fs/promises';
 import { resolve, isAbsolute, join, relative, sep } from 'node:path';
 import { parseDocument } from 'yaml';
-import { A as AGENT_SKILLS_SCHEMA } from '../shared/nuxt-ai-ready.B5l-paa5.mjs';
+import { A as AGENT_SKILLS_SCHEMA } from '../shared/nuxt-ai-ready.CxJE2WLA.mjs';
 import 'node:module';
 import '@nuxt/kit';
 import 'defu';
@@ -12,6 +12,7 @@ import 'pkg-types';
 import 'node:url';
 import '../../dist/runtime/markdown-path.js';
 import '../../dist/runtime/server/utils/sitemap-md.js';
+import '../../dist/runtime/cache-control.js';
 import '../../dist/runtime/server/utils/discovery-response.js';
 import 'pathe';
 import 'nuxtseo-shared/i18n';

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, joinURL, withBase } from 'ufo';
-import { l as logger, s as supportsNativeNodeSqlite, M as MARKDOWN_LINK_AVAILABILITY_FILE } from '../shared/nuxt-ai-ready.B5l-paa5.mjs';
+import { l as logger, s as supportsNativeNodeSqlite, M as MARKDOWN_LINK_AVAILABILITY_FILE } from '../shared/nuxt-ai-ready.CxJE2WLA.mjs';
 import { normalizePagePath, toMarkdownPath } from '../../dist/runtime/markdown-path.js';
 import { toDeployedRoute, toLogicalRoute } from '../../dist/runtime/route-path.js';
 import { initSchema, computeContentHash, insertPage, queryAllPages, exportDbDump } from '../../dist/runtime/server/db/shared.js';
@@ -19,6 +19,7 @@ import 'nuxt-site-config/kit';
 import 'nuxtseo-shared/kit';
 import 'pkg-types';
 import 'node:url';
+import '../../dist/runtime/cache-control.js';
 import '../../dist/runtime/server/utils/discovery-response.js';
 import 'pathe';
 import 'nuxtseo-shared/i18n';

package/dist/module.json

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

package/dist/module.mjs

@@ -7,11 +7,12 @@ import 'defu';
 import 'nuxt-site-config/kit';
 import 'nuxtseo-shared/kit';
 import 'pkg-types';
-export { m as default } from './shared/nuxt-ai-ready.B5l-paa5.mjs';
+export { m as default } from './shared/nuxt-ai-ready.CxJE2WLA.mjs';
 import '../dist/runtime/markdown-path.js';
 import '../dist/runtime/server/utils/sitemap-md.js';
 import '../dist/runtime/server/utils/discovery-response.js';
 import 'node:url';
+import '../dist/runtime/cache-control.js';
 import 'pathe';
 import 'nuxtseo-shared/i18n';
 import '../dist/runtime/route-path.js';

package/dist/runtime/cache-control.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Shared `Cache-Control` for public AI-ready endpoints.
+ *
+ * Freshness goes in `max-age` only. Cloudflare disables stale serving when
+ * `s-maxage` is present, so `stale-while-revalidate` would never apply at
+ * the edge.
+ */
+export declare function publicCacheControl(maxAgeSeconds: number, staleSeconds: number): string;

package/dist/runtime/cache-control.js

@@ -0,0 +1,3 @@
+export function publicCacheControl(maxAgeSeconds, staleSeconds) {
+  return staleSeconds > 0 ? `public, max-age=${maxAgeSeconds}, stale-while-revalidate=${staleSeconds}` : `public, max-age=${maxAgeSeconds}`;
+}

package/dist/runtime/server/routes/agent-skills-artifact.js

@@ -1,6 +1,7 @@
 import { localAgentSkillArtifacts } from "#ai-ready-virtual/agent-skills.mjs";
 import { assertMethod, createError, eventHandler, getRequestURL, setHeader } from "#nuxtseo/h3";
 import { useRuntimeConfig } from "#nuxtseo/nitro";
+import { publicCacheControl } from "../../cache-control.js";
 import { toLogicalRoute } from "../../route-path.js";
 export default eventHandler((event) => {
   assertMethod(event, ["GET", "HEAD"]);
@@ -13,7 +14,7 @@ export default eventHandler((event) => {
     });
   }
   setHeader(event, "Content-Type", "text/markdown; charset=utf-8");
-  setHeader(event, "Cache-Control", "public, max-age=3600, s-maxage=3600, stale-while-revalidate=86400");
+  setHeader(event, "Cache-Control", publicCacheControl(3600, 86400));
   setHeader(event, "Access-Control-Allow-Origin", "*");
   return content;
 });

package/dist/runtime/server/routes/agent-skills-index.js

@@ -1,9 +1,10 @@
 import { agentSkillsIndex } from "#ai-ready-virtual/agent-skills.mjs";
 import { assertMethod, eventHandler, setHeader } from "#nuxtseo/h3";
+import { publicCacheControl } from "../../cache-control.js";
 export default eventHandler((event) => {
   assertMethod(event, ["GET", "HEAD"]);
   setHeader(event, "Content-Type", "application/json; charset=utf-8");
-  setHeader(event, "Cache-Control", "public, max-age=3600, s-maxage=3600, stale-while-revalidate=86400");
+  setHeader(event, "Cache-Control", publicCacheControl(3600, 86400));
   setHeader(event, "Access-Control-Allow-Origin", "*");
   return agentSkillsIndex;
 });

package/dist/runtime/server/routes/llms-full.txt.get.js

@@ -2,6 +2,7 @@ import { eventHandler, sendIterable, setHeader, setResponseHeader } from "#nuxts
 import { useRuntimeConfig } from "#nuxtseo/nitro";
 import { getSiteConfig } from "#site-config/server/composables";
 import { withSiteUrl } from "#site-config/server/composables/utils";
+import { publicCacheControl } from "../../cache-control.js";
 import { toDeployedRoute } from "../../route-path.js";
 import { countPages, streamPages } from "../db/queries.js";
 import { buildLlmsFullTxtHeader, formatPageForLlmsFullTxt } from "../utils/llms-full.js";
@@ -37,7 +38,7 @@ Runtime indexing may not be configured correctly for this environment.`;
     return `${header}No pages indexed. Run \`nuxi generate\` or enable runtime indexing.`;
   }
   setHeader(event, "Content-Type", "text/plain; charset=utf-8");
-  setResponseHeader(event, "Cache-Control", "public, max-age=3600, s-maxage=3600, stale-while-revalidate=86400");
+  setResponseHeader(event, "Cache-Control", publicCacheControl(3600, 86400));
   const siteUrl = siteConfig.url;
   async function* generateContent() {
     yield header;

package/dist/runtime/server/routes/llms.txt.get.js

@@ -1,5 +1,6 @@
 import { eventHandler, setHeader } from "#nuxtseo/h3";
 import { defineCachedFunction, useRuntimeConfig } from "#nuxtseo/nitro";
+import { publicCacheControl } from "../../cache-control.js";
 import { buildLlmsTxt } from "../../llms-txt-utils.js";
 const cachedBuilders = /* @__PURE__ */ new Map();
 function getBuildLlmsTxtCached(maxAge) {
@@ -22,7 +23,7 @@ export default eventHandler(async (event) => {
   const content = cacheEnabled ? await getBuildLlmsTxtCached(cacheSeconds)(event) : await buildLlmsTxt(event);
   setHeader(event, "Content-Type", "text/plain; charset=utf-8");
   if (cacheEnabled) {
-    setHeader(event, "Cache-Control", `public, max-age=${cacheSeconds}, s-maxage=${cacheSeconds}, stale-while-revalidate=3600`);
+    setHeader(event, "Cache-Control", publicCacheControl(cacheSeconds, 3600));
   }
   return content;
 });

package/dist/runtime/server/routes/sitemap.md.get.js

@@ -1,6 +1,7 @@
 import { eventHandler, setHeader } from "#nuxtseo/h3";
 import { defineCachedFunction, useRuntimeConfig } from "#nuxtseo/nitro";
 import { getSiteConfig } from "#site-config/server/composables";
+import { publicCacheControl } from "../../cache-control.js";
 import { toMarkdownPath } from "../../markdown-path.js";
 import { toDeployedRoute } from "../../route-path.js";
 import { queryPages } from "../db/queries.js";
@@ -45,7 +46,7 @@ export default eventHandler(async (event) => {
   const cacheEnabled = !import.meta.dev && cacheSeconds > 0;
   setHeader(event, "Content-Type", "text/markdown; charset=utf-8");
   if (cacheEnabled) {
-    setHeader(event, "Cache-Control", `public, max-age=${cacheSeconds}, s-maxage=${cacheSeconds}, stale-while-revalidate=3600`);
+    setHeader(event, "Cache-Control", publicCacheControl(cacheSeconds, 3600));
   }
   return cacheEnabled ? await getBuildSitemapMdCached(cacheSeconds)(event) : await buildSitemapMarkdown(event);
 });

package/dist/shared/{nuxt-ai-ready.B5l-paa5.mjs → nuxt-ai-ready.CxJE2WLA.mjs}

@@ -10,6 +10,7 @@ import { readPackageJSON, resolvePackageJSON } from 'pkg-types';
 import { fileURLToPath, pathToFileURL } from 'node:url';
 import { isReservedPath, normalizePagePath, toMarkdownPath } from '../../dist/runtime/markdown-path.js';
 import { SITEMAP_MD_ROUTE } from '../../dist/runtime/server/utils/sitemap-md.js';
+import { publicCacheControl } from '../../dist/runtime/cache-control.js';
 import { MCP_SERVER_CARD_MEDIA_TYPE, AI_CATALOG_MEDIA_TYPE } from '../../dist/runtime/server/utils/discovery-response.js';
 import { isAbsolute, join as join$1 } from 'pathe';
 import { resolveI18nConfig, toRuntimeI18nConfig as toRuntimeI18nConfig$1 } from 'nuxtseo-shared/i18n';
@@ -278,7 +279,7 @@ declare module '#ai-ready-virtual/agent-skills.mjs' {
 
 const AGENT_SKILLS_SCHEMA = "https://schemas.agentskills.io/discovery/0.2.0/schema.json";
 const AGENT_SKILLS_INDEX_ROUTE = "/.well-known/agent-skills/index.json";
-const AGENT_SKILLS_CACHE_CONTROL = "public, max-age=3600, s-maxage=3600, stale-while-revalidate=86400";
+const AGENT_SKILLS_CACHE_CONTROL = publicCacheControl(3600, 86400);
 function resolveExternalSkillUrl(href, indexUrl) {
   const normalized = href.replaceAll(/[\t\n\r]/g, "");
   if (URL.canParse(normalized))

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "nuxt-ai-ready",
   "type": "module",
-  "version": "2.4.0",
+  "version": "2.4.1",
   "description": "Best practice AI & LLM discoverability for Nuxt sites.",
   "author": {
     "name": "Harlan Wilton",