nuxt-ai-ready 0.7.5 → 0.7.7

package/dist/module.json

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

package/dist/module.mjs

@@ -84,11 +84,13 @@ async function initCrawler(state) {
     return;
   if (state.dbPath) {
     await mkdir(dirname(state.dbPath), { recursive: true });
-    const { default: betterSqlite3 } = await import('db0/connectors/better-sqlite3');
-    const connector = betterSqlite3({ path: state.dbPath });
+    const nodeVersion = Number.parseInt(process.versions.node?.split(".")[0] || "0");
+    const connectorPath = nodeVersion >= 22 ? "db0/connectors/node-sqlite" : "db0/connectors/better-sqlite3";
+    const { default: connectorFn } = await import(connectorPath);
+    const connector = connectorFn({ path: state.dbPath });
     state.db = createAdapter(connector);
     await initSchema(state.db);
-    logger.debug(`Crawler initialized with SQLite at ${state.dbPath}`);
+    logger.debug(`Crawler initialized with SQLite at ${state.dbPath} using ${connectorPath}`);
   }
   if (state.llmsFullTxtPath) {
     await mkdir(dirname(state.llmsFullTxtPath), { recursive: true });
@@ -370,6 +372,12 @@ declare module '#ai-ready/adapter' {
   export default connector
 }
 
+declare module '#ai-ready/db-provider' {
+  import type { H3Event } from 'h3'
+  import type { Connector } from 'db0'
+  export function createConnector(event?: H3Event): Promise<Connector>
+}
+
 export {}
 `
   });
@@ -404,7 +412,7 @@ function refineDatabaseConfig(config, rootDir) {
   if (type === "d1") {
     return {
       type: "d1",
-      bindingName: config.bindingName || "AI_READY_DB"
+      bindingName: config.bindingName || "DB"
     };
   }
   return {
@@ -469,6 +477,16 @@ const module$1 = defineNuxtModule({
     const adapterPath = await resolveDatabaseAdapter(dbType);
     nuxt.options.alias["#ai-ready/adapter"] = adapterPath;
     nuxt.options.nitro.alias["#ai-ready/adapter"] = adapterPath;
+    let providerPath = resolve("./runtime/server/db/provider/sqlite-node");
+    if (dbType === "d1") {
+      providerPath = resolve("./runtime/server/db/provider/d1");
+    } else if (dbType === "libsql") {
+      providerPath = resolve("./runtime/server/db/provider/libsql");
+    } else if (process.versions.bun) {
+      providerPath = resolve("./runtime/server/db/provider/sqlite-bun");
+    }
+    nuxt.options.alias["#ai-ready/db-provider"] = providerPath;
+    nuxt.options.nitro.alias["#ai-ready/db-provider"] = providerPath;
     if (!nuxt.options.mcp?.name) {
       nuxt.options.mcp = nuxt.options.mcp || {};
       nuxt.options.mcp.name = useSiteConfig().name;
@@ -579,12 +597,20 @@ export async function readPageDataFromFilesystem() {
     return { pages: [], errorRoutes: [] }
   }
 
-  // Use better-sqlite3 to read pages
-  const Database = (await import('better-sqlite3')).default
-  const db = new Database(dbPath, { readonly: true })
-
-  const rows = db.prepare('SELECT route, title, description, markdown, headings, keywords, updated_at, is_error FROM ai_ready_pages').all()
-  db.close()
+  let rows = []
+  const nodeVersion = Number.parseInt(process.versions.node?.split('.')[0] || '0')
+  if (nodeVersion >= 22) {
+    const { DatabaseSync } = await import('node:sqlite')
+    const db = new DatabaseSync(dbPath, { open: true })
+    rows = db.prepare('SELECT route, title, description, markdown, headings, keywords, updated_at, is_error FROM ai_ready_pages').all()
+    db.close()
+  }
+  else {
+    const Database = (await import('better-sqlite3')).default
+    const db = new Database(dbPath, { readonly: true })
+    rows = db.prepare('SELECT route, title, description, markdown, headings, keywords, updated_at, is_error FROM ai_ready_pages').all()
+    db.close()
+  }
 
   const pages = rows.filter(r => !r.is_error).map(r => ({
     route: r.route,

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

@@ -1,7 +1,5 @@
-import { mkdir } from "node:fs/promises";
-import adapter from "#ai-ready/adapter";
-import { useNitroApp, useRuntimeConfig } from "nitropack/runtime";
-import { dirname } from "pathe";
+import { createConnector } from "#ai-ready/db-provider";
+import { useNitroApp } from "nitropack/runtime";
 import { createAdapter, initSchema } from "./shared.js";
 const DB_KEY = "_aiReadyDb";
 export function useDatabase(event) {
@@ -12,24 +10,7 @@ export function useDatabase(event) {
   return nitro[DB_KEY];
 }
 async function initDatabase(event) {
-  const config = useRuntimeConfig()["nuxt-ai-ready"];
-  let connector;
-  if (config.database.type === "d1") {
-    const binding = event?.context?.cloudflare?.env?.[config.database.bindingName || "AI_READY_DB"];
-    if (!binding) {
-      throw new Error(`D1 binding '${config.database.bindingName || "AI_READY_DB"}' not found in event context`);
-    }
-    connector = adapter({ binding });
-  } else if (config.database.type === "libsql") {
-    connector = adapter({
-      url: config.database.url,
-      authToken: config.database.authToken
-    });
-  } else {
-    const dbPath = config.database.filename || ".data/ai-ready/pages.db";
-    await mkdir(dirname(dbPath), { recursive: true });
-    connector = adapter({ path: dbPath });
-  }
+  const connector = await createConnector(event);
   if (!connector) {
     throw new Error("Failed to initialize database connector");
   }

package/dist/runtime/server/db/provider/d1.d.ts

@@ -0,0 +1,3 @@
+import type { Connector } from 'db0';
+import type { H3Event } from 'h3';
+export declare function createConnector(event?: H3Event): Promise<Connector>;

package/dist/runtime/server/db/provider/d1.js

@@ -0,0 +1,28 @@
+import adapter from "#ai-ready/adapter";
+import { useRuntimeConfig } from "nitropack/runtime";
+export async function createConnector(event) {
+  const config = useRuntimeConfig(event)["nuxt-ai-ready"];
+  const bindingName = config.database.bindingName || "DB";
+  let cloudflareEnv;
+  try {
+    const context = event?.context || useEvent?.()?.context;
+    cloudflareEnv = context?.cloudflare?.env;
+  } catch {
+    cloudflareEnv = globalThis.__env__;
+  }
+  const binding = cloudflareEnv?.[bindingName];
+  if (!binding) {
+    const debug = {
+      hasEvent: !!event,
+      hasContext: !!event?.context,
+      hasCloudflare: !!event?.context?.cloudflare,
+      hasCloudflareEnv: !!event?.context?.cloudflare?.env,
+      hasGlobalEnv: !!globalThis.__env__,
+      cloudflareEnvKeys: cloudflareEnv ? Object.keys(cloudflareEnv) : [],
+      bindingName
+    };
+    console.error(`[D1 Debug] Binding '${bindingName}' not found. Context:`, JSON.stringify(debug, null, 2));
+    throw new Error(`D1 binding '${bindingName}' not found in event.context.cloudflare.env or globalThis.__env__`);
+  }
+  return adapter({ binding });
+}

package/dist/runtime/server/db/provider/libsql.d.ts

@@ -0,0 +1,3 @@
+import type { Connector } from 'db0';
+import type { H3Event } from 'h3';
+export declare function createConnector(event?: H3Event): Promise<Connector>;

package/dist/runtime/server/db/provider/libsql.js

@@ -0,0 +1,9 @@
+import adapter from "#ai-ready/adapter";
+import { useRuntimeConfig } from "nitropack/runtime";
+export async function createConnector(event) {
+  const config = useRuntimeConfig(event)["nuxt-ai-ready"];
+  return adapter({
+    url: config.database.url,
+    authToken: config.database.authToken
+  });
+}

package/dist/runtime/server/db/provider/sqlite-bun.d.ts

@@ -0,0 +1,3 @@
+import type { Connector } from 'db0';
+import type { H3Event } from 'h3';
+export declare function createConnector(event?: H3Event): Promise<Connector>;

package/dist/runtime/server/db/provider/sqlite-bun.js

@@ -0,0 +1,10 @@
+import { mkdir } from "node:fs/promises";
+import adapter from "#ai-ready/adapter";
+import { useRuntimeConfig } from "nitropack/runtime";
+import { dirname } from "pathe";
+export async function createConnector(event) {
+  const config = useRuntimeConfig(event)["nuxt-ai-ready"];
+  const dbPath = config.database.filename || ".data/ai-ready/pages.db";
+  await mkdir(dirname(dbPath), { recursive: true });
+  return adapter({ path: dbPath });
+}

package/dist/runtime/server/db/provider/sqlite-node.d.ts

@@ -0,0 +1,3 @@
+import type { Connector } from 'db0';
+import type { H3Event } from 'h3';
+export declare function createConnector(event?: H3Event): Promise<Connector>;

package/dist/runtime/server/db/provider/sqlite-node.js

@@ -0,0 +1,10 @@
+import { mkdir } from "node:fs/promises";
+import adapter from "#ai-ready/adapter";
+import { useRuntimeConfig } from "nitropack/runtime";
+import { dirname } from "pathe";
+export async function createConnector(event) {
+  const config = useRuntimeConfig(event)["nuxt-ai-ready"];
+  const dbPath = config.database.filename || ".data/ai-ready/pages.db";
+  await mkdir(dirname(dbPath), { recursive: true });
+  return adapter({ path: dbPath });
+}

package/dist/runtime/server/plugins/sitemap-seeder.js

@@ -9,7 +9,11 @@ export default defineNitroPlugin((nitro) => {
   nitro.hooks.hook("request", async (event) => {
     if (!seeding) {
       seeding = seedFromSitemap(event).catch((err) => {
-        logger.error("[sitemap-seeder] Failed to seed:", err);
+        if (err.message?.includes("D1 binding")) {
+          logger.info("[sitemap-seeder] Skipping runtime seeding - using static pages data");
+        } else {
+          logger.error("[sitemap-seeder] Failed to seed:", err);
+        }
       });
     }
   });

package/dist/runtime/server/routes/__ai-ready-debug.get.d.ts

@@ -62,6 +62,19 @@ interface DebugInfo {
             note: string;
         };
     };
+    cloudflare?: {
+        hasContext: boolean;
+        hasCloudflare: boolean;
+        hasCloudflareEnv: boolean;
+        hasContextEnv: boolean;
+        contextKeys: string[];
+        cloudflareKeys: string[];
+        cloudflareEnvKeys: string[];
+        databaseConfig: {
+            type: string;
+            bindingName?: string;
+        };
+    };
     diagnostics: {
         issues: string[];
         suggestions: string[];

package/dist/runtime/server/routes/__ai-ready-debug.get.js

@@ -19,10 +19,23 @@ export default eventHandler(async (event) => {
   } else {
     mode = "production";
   }
-  const [pages, errorRoutes] = await Promise.all([
-    queryPages(event),
-    queryPages(event, { where: { hasError: true } })
-  ]);
+  const issues = [];
+  const suggestions = [];
+  let pages = [];
+  let errorRoutes = [];
+  let dbError = null;
+  try {
+    const [p, e] = await Promise.all([
+      queryPages(event),
+      queryPages(event, { where: { hasError: true } })
+    ]);
+    pages = p;
+    errorRoutes = e;
+  } catch (err) {
+    dbError = err.message || String(err);
+    issues.push(`Database error: ${dbError}`);
+    suggestions.push("Verify your database configuration (D1 binding, SQLite path, etc.)");
+  }
   let source;
   if (isDev) {
     source = "empty (dev mode returns empty array)";
@@ -75,8 +88,6 @@ export default eventHandler(async (event) => {
     pageCount: publicData?.pages?.length ?? 0,
     source: jsonFileSource
   };
-  const issues = [];
-  const suggestions = [];
   if (mode === "development") {
     issues.push("Development mode: page data is intentionally empty");
     suggestions.push("Run `nuxi generate` or `nuxi build --prerender` to generate page data");
@@ -95,44 +106,61 @@ export default eventHandler(async (event) => {
   let runtimeSyncInfo;
   let indexNowInfo;
   let cronRunsInfo;
-  if (!isDev && !isPrerender) {
-    const [total, pending, sitemapSeededAt, cronRuns] = await Promise.all([
-      countPages(event),
-      countPages(event, { where: { pending: true } }),
-      getSitemapSeededAt(event),
-      getRecentCronRuns(event, 20)
-    ]);
-    runtimeSyncInfo = {
-      total,
-      indexed: total - pending,
-      pending,
-      sitemapSeededAt: sitemapSeededAt ? new Date(sitemapSeededAt).toISOString() : null
-    };
-    cronRunsInfo = cronRuns.map((run) => ({
-      id: run.id,
-      startedAt: new Date(run.startedAt).toISOString(),
-      finishedAt: run.finishedAt ? new Date(run.finishedAt).toISOString() : null,
-      durationMs: run.durationMs,
-      status: run.status,
-      pagesIndexed: run.pagesIndexed,
-      pagesRemaining: run.pagesRemaining,
-      indexNowSubmitted: run.indexNowSubmitted,
-      indexNowRemaining: run.indexNowRemaining,
-      errors: run.errors
-    }));
-    if (runtimeConfig.indexNowKey) {
-      const [indexNowPending, indexNowStats] = await Promise.all([
-        countPagesNeedingIndexNowSync(event),
-        getIndexNowStats(event)
+  if (!isDev && !isPrerender && !dbError) {
+    try {
+      const [total, pending, sitemapSeededAt, cronRuns] = await Promise.all([
+        countPages(event),
+        countPages(event, { where: { pending: true } }),
+        getSitemapSeededAt(event),
+        getRecentCronRuns(event, 20)
       ]);
-      indexNowInfo = {
-        pending: indexNowPending,
-        totalSubmitted: indexNowStats.totalSubmitted,
-        lastSubmittedAt: indexNowStats.lastSubmittedAt ? new Date(indexNowStats.lastSubmittedAt).toISOString() : null,
-        lastError: indexNowStats.lastError
+      runtimeSyncInfo = {
+        total,
+        indexed: total - pending,
+        pending,
+        sitemapSeededAt: sitemapSeededAt ? new Date(sitemapSeededAt).toISOString() : null
       };
+      cronRunsInfo = cronRuns.map((run) => ({
+        id: run.id,
+        startedAt: new Date(run.startedAt).toISOString(),
+        finishedAt: run.finishedAt ? new Date(run.finishedAt).toISOString() : null,
+        durationMs: run.durationMs,
+        status: run.status,
+        pagesIndexed: run.pagesIndexed,
+        pagesRemaining: run.pagesRemaining,
+        indexNowSubmitted: run.indexNowSubmitted,
+        indexNowRemaining: run.indexNowRemaining,
+        errors: run.errors
+      }));
+      if (runtimeConfig.indexNowKey) {
+        const [indexNowPending, indexNowStats] = await Promise.all([
+          countPagesNeedingIndexNowSync(event),
+          getIndexNowStats(event)
+        ]);
+        indexNowInfo = {
+          pending: indexNowPending,
+          totalSubmitted: indexNowStats.totalSubmitted,
+          lastSubmittedAt: indexNowStats.lastSubmittedAt ? new Date(indexNowStats.lastSubmittedAt).toISOString() : null,
+          lastError: indexNowStats.lastError
+        };
+      }
+    } catch (err) {
+      issues.push(`Runtime stats error: ${err.message || String(err)}`);
     }
   }
+  const cloudflareInfo = {
+    hasContext: !!event.context,
+    hasCloudflare: !!event.context?.cloudflare,
+    hasCloudflareEnv: !!event.context?.cloudflare?.env,
+    hasContextEnv: !!event.context?.env,
+    contextKeys: event.context ? Object.keys(event.context) : [],
+    cloudflareKeys: event.context?.cloudflare ? Object.keys(event.context.cloudflare) : [],
+    cloudflareEnvKeys: event.context?.cloudflare?.env ? Object.keys(event.context.cloudflare.env) : [],
+    databaseConfig: {
+      type: runtimeConfig.database?.type || "unknown",
+      bindingName: runtimeConfig.database?.bindingName
+    }
+  };
   const debugInfo = {
     version: runtimeConfig.version || "unknown",
     environment: {
@@ -164,6 +192,7 @@ export default eventHandler(async (event) => {
       pageDataModule: pageDataModuleInfo,
       readPageDataModule: readPageDataModuleInfo
     },
+    cloudflare: cloudflareInfo,
     diagnostics: {
       issues,
       suggestions

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

@@ -18,7 +18,15 @@ export default eventHandler(async (event) => {
     },
     config.llmsTxt
   );
-  const total = await countPages(event);
+  let total = 0;
+  try {
+    total = await countPages(event);
+  } catch (err) {
+    setHeader(event, "Content-Type", "text/plain; charset=utf-8");
+    return `${header}Database error: ${err.message || String(err)}
+
+Runtime indexing may not be configured correctly for this environment.`;
+  }
   if (total === 0) {
     setHeader(event, "Content-Type", "text/plain; charset=utf-8");
     return `${header}No pages indexed. Run \`nuxi generate\` or enable runtime indexing.`;

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "nuxt-ai-ready",
   "type": "module",
-  "version": "0.7.5",
+  "version": "0.7.7",
   "description": "Best practice AI & LLM discoverability for Nuxt sites.",
   "author": {
     "name": "Harlan Wilton",
@@ -60,7 +60,7 @@
     "ufo": "^1.6.2"
   },
   "devDependencies": {
-    "@antfu/eslint-config": "^6.7.3",
+    "@antfu/eslint-config": "^7.0.0",
     "@arethetypeswrong/cli": "^0.18.2",
     "@headlessui/vue": "^1.7.23",
     "@nuxt/content": "^3.10.0",
@@ -77,10 +77,10 @@
     "@vitest/coverage-v8": "^4.0.17",
     "@vue/test-utils": "^2.4.6",
     "@vueuse/nuxt": "^14.1.0",
-    "agents": "^0.3.4",
-    "ai": "^6.0.30",
+    "agents": "^0.3.5",
+    "ai": "^6.0.33",
     "better-sqlite3": "^12.6.0",
-    "bumpp": "^10.3.2",
+    "bumpp": "^10.4.0",
     "eslint": "^9.39.2",
     "execa": "^9.6.1",
     "happy-dom": "^20.1.0",
@@ -94,7 +94,7 @@
     "vue": "^3.5.26",
     "vue-router": "^4.6.4",
     "vue-tsc": "^3.2.2",
-    "wrangler": "^4.58.0",
+    "wrangler": "^4.59.1",
     "zod": "^4.3.5"
   },
   "resolutions": {