nuxt-ai-ready 0.8.0 → 0.8.1

package/dist/module.json

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

package/dist/module.mjs

@@ -11,6 +11,7 @@ import { parseSitemapXml } from '@nuxtjs/sitemap/utils';
 import { colorize } from 'consola/utils';
 import { withBase } from 'ufo';
 import { createAdapter, initSchema, computeContentHash, insertPage, queryAllPages, exportDbDump } from '../dist/runtime/server/db/shared.js';
+import { comparePageHashes, submitToIndexNowShared } from '../dist/runtime/server/utils/indexnow-shared.js';
 import { buildLlmsFullTxtHeader, formatPageForLlmsFullTxt } from '../dist/runtime/server/utils/llms-full.js';
 import { join as join$1, isAbsolute } from 'pathe';
 
@@ -67,84 +68,6 @@ function hookNuxtSeoProLicense() {
   }
 }
 
-const INDEXNOW_HOSTS = ["api.indexnow.org", "www.bing.com"];
-function getIndexNowEndpoints() {
-  const testEndpoint = process.env.INDEXNOW_TEST_ENDPOINT;
-  if (testEndpoint) {
-    return [testEndpoint];
-  }
-  return INDEXNOW_HOSTS.map((host) => `https://${host}/indexnow`);
-}
-function buildIndexNowBody(routes, key, siteUrl) {
-  const urlList = routes.map(
-    (route) => route.startsWith("http") ? route : `${siteUrl}${route}`
-  );
-  return {
-    host: new URL(siteUrl).host,
-    key,
-    keyLocation: `${siteUrl}/${key}.txt`,
-    urlList
-  };
-}
-async function submitToIndexNow(routes, key, siteUrl, options) {
-  if (!siteUrl) {
-    return { success: false, error: "Site URL not configured" };
-  }
-  const fetchFn = options?.fetchFn ?? globalThis.fetch;
-  const log = options?.logger;
-  const body = buildIndexNowBody(routes, key, siteUrl);
-  const endpoints = getIndexNowEndpoints();
-  let lastError;
-  for (const endpoint of endpoints) {
-    log?.debug(`[indexnow] Submitting ${body.urlList.length} URLs to ${endpoint}`);
-    const response = await fetchFn(endpoint, {
-      method: "POST",
-      headers: { "Content-Type": "application/json" },
-      body: JSON.stringify(body)
-    }).then((r) => r.ok ? { ok: true } : { error: `HTTP ${r.status}` }).catch((err) => ({ error: err.message }));
-    if ("error" in response) {
-      lastError = response.error;
-      if (lastError?.includes("429")) {
-        log?.warn(`[indexnow] Rate limited on ${endpoint}, trying fallback...`);
-        continue;
-      }
-      log?.warn(`[indexnow] Submission failed on ${endpoint}: ${lastError}`);
-      return { success: false, error: lastError, host: endpoint };
-    }
-    log?.debug(`[indexnow] Successfully submitted ${body.urlList.length} URLs via ${endpoint}`);
-    return { success: true, host: endpoint };
-  }
-  return {
-    success: false,
-    error: lastError || "All endpoints rate limited",
-    host: endpoints[endpoints.length - 1]
-  };
-}
-function comparePageHashes(currentPages, prevMeta) {
-  if (!prevMeta?.pages) {
-    return { changed: [], added: [], removed: [] };
-  }
-  const prevHashes = new Map(prevMeta.pages.map((p) => [p.route, p.hash]));
-  const currentRoutes = new Set(currentPages.map((p) => p.route));
-  const changed = [];
-  const added = [];
-  for (const page of currentPages) {
-    const prevHash = prevHashes.get(page.route);
-    if (!prevHash) {
-      added.push(page.route);
-    } else if (prevHash !== page.hash) {
-      changed.push(page.route);
-    }
-  }
-  const removed = [];
-  for (const route of prevHashes.keys()) {
-    if (!currentRoutes.has(route)) {
-      removed.push(route);
-    }
-  }
-  return { changed, added, removed };
-}
-
 async function fetchPreviousMeta(siteUrl, indexNowKey) {
   const metaUrl = `${siteUrl}/__ai-ready/pages.meta.json`;
   logger.debug(`[indexnow] Fetching previous meta from ${metaUrl}`);
@@ -169,7 +92,7 @@ async function handleStaticIndexNow(currentPages, siteUrl, indexNowKey, prevMeta
     return;
   }
   logger.info(`[indexnow] Submitting ${totalChanged} changed pages (${changed.length} modified, ${added.length} new)`);
-  const result = await submitToIndexNow(
+  const result = await submitToIndexNowShared(
     [...changed, ...added],
     indexNowKey,
     siteUrl,

package/dist/runtime/server/utils/indexnow-shared.d.ts

@@ -0,0 +1,57 @@
+/**
+ * Shared IndexNow utilities for build-time and runtime
+ * This module has no Nuxt/Nitro dependencies so it can be used in both contexts
+ */
+export declare const INDEXNOW_HOSTS: string[];
+/**
+ * Get IndexNow endpoints, with test override support
+ */
+export declare function getIndexNowEndpoints(): string[];
+export interface IndexNowSubmitResult {
+    success: boolean;
+    error?: string;
+    host?: string;
+}
+export interface IndexNowRequestBody {
+    host: string;
+    key: string;
+    keyLocation: string;
+    urlList: string[];
+}
+/**
+ * Build the IndexNow API request body
+ */
+export declare function buildIndexNowBody(routes: string[], key: string, siteUrl: string): IndexNowRequestBody;
+export interface SubmitOptions {
+    /** Custom fetch implementation (defaults to globalThis.fetch) */
+    fetchFn?: typeof fetch;
+    /** Logger for debug/warn messages (optional) */
+    logger?: {
+        debug: (msg: string) => void;
+        warn: (msg: string) => void;
+    };
+}
+/**
+ * Submit URLs to IndexNow API with fallback on rate limit
+ * Works in both build-time (native fetch) and runtime ($fetch) contexts
+ */
+export declare function submitToIndexNowShared(routes: string[], key: string, siteUrl: string, options?: SubmitOptions): Promise<IndexNowSubmitResult>;
+export interface PageHashMeta {
+    route: string;
+    hash: string;
+}
+export interface BuildMeta {
+    buildId: string;
+    pageCount: number;
+    createdAt: string;
+    pages: PageHashMeta[];
+}
+/**
+ * Compare page hashes between current and previous builds
+ * Returns changed, added, and removed routes
+ */
+export declare function comparePageHashes(currentPages: PageHashMeta[], prevMeta: BuildMeta | null | undefined): {
+    changed: string[];
+    added: string[];
+    removed: string[];
+};

package/dist/runtime/server/utils/indexnow-shared.js

@@ -0,0 +1,77 @@
+export const INDEXNOW_HOSTS = ["api.indexnow.org", "www.bing.com"];
+export function getIndexNowEndpoints() {
+  const testEndpoint = process.env.INDEXNOW_TEST_ENDPOINT;
+  if (testEndpoint) {
+    return [testEndpoint];
+  }
+  return INDEXNOW_HOSTS.map((host) => `https://${host}/indexnow`);
+}
+export function buildIndexNowBody(routes, key, siteUrl) {
+  const urlList = routes.map(
+    (route) => route.startsWith("http") ? route : `${siteUrl}${route}`
+  );
+  return {
+    host: new URL(siteUrl).host,
+    key,
+    keyLocation: `${siteUrl}/${key}.txt`,
+    urlList
+  };
+}
+export async function submitToIndexNowShared(routes, key, siteUrl, options) {
+  if (!siteUrl) {
+    return { success: false, error: "Site URL not configured" };
+  }
+  const fetchFn = options?.fetchFn ?? globalThis.fetch;
+  const log = options?.logger;
+  const body = buildIndexNowBody(routes, key, siteUrl);
+  const endpoints = getIndexNowEndpoints();
+  let lastError;
+  for (const endpoint of endpoints) {
+    log?.debug(`[indexnow] Submitting ${body.urlList.length} URLs to ${endpoint}`);
+    const response = await fetchFn(endpoint, {
+      method: "POST",
+      headers: { "Content-Type": "application/json" },
+      body: JSON.stringify(body)
+    }).then((r) => r.ok ? { ok: true } : { error: `HTTP ${r.status}` }).catch((err) => ({ error: err.message }));
+    if ("error" in response) {
+      lastError = response.error;
+      if (lastError?.includes("429")) {
+        log?.warn(`[indexnow] Rate limited on ${endpoint}, trying fallback...`);
+        continue;
+      }
+      log?.warn(`[indexnow] Submission failed on ${endpoint}: ${lastError}`);
+      return { success: false, error: lastError, host: endpoint };
+    }
+    log?.debug(`[indexnow] Successfully submitted ${body.urlList.length} URLs via ${endpoint}`);
+    return { success: true, host: endpoint };
+  }
+  return {
+    success: false,
+    error: lastError || "All endpoints rate limited",
+    host: endpoints[endpoints.length - 1]
+  };
+}
+export function comparePageHashes(currentPages, prevMeta) {
+  if (!prevMeta?.pages) {
+    return { changed: [], added: [], removed: [] };
+  }
+  const prevHashes = new Map(prevMeta.pages.map((p) => [p.route, p.hash]));
+  const currentRoutes = new Set(currentPages.map((p) => p.route));
+  const changed = [];
+  const added = [];
+  for (const page of currentPages) {
+    const prevHash = prevHashes.get(page.route);
+    if (!prevHash) {
+      added.push(page.route);
+    } else if (prevHash !== page.hash) {
+      changed.push(page.route);
+    }
+  }
+  const removed = [];
+  for (const route of prevHashes.keys()) {
+    if (!currentRoutes.has(route)) {
+      removed.push(route);
+    }
+  }
+  return { changed, added, removed };
+}

package/dist/runtime/server/utils/indexnow.d.ts

@@ -1,5 +1,5 @@
 import type { H3Event } from 'h3';
-export type { BuildMeta, IndexNowSubmitResult, PageHashMeta } from '../../../shared/indexnow.js';
+export type { BuildMeta, IndexNowSubmitResult, PageHashMeta } from './indexnow-shared.js';
 export interface IndexNowResult {
     success: boolean;
     submitted: number;

package/dist/runtime/server/utils/indexnow.js

@@ -1,6 +1,5 @@
 import { getSiteConfig } from "#site-config/server/composables";
 import { useRuntimeConfig } from "nitropack/runtime";
-import { submitToIndexNow as submitToIndexNowShared } from "../../../shared/indexnow";
 import { useDatabase } from "../db/index.js";
 import {
   batchIndexNowUpdate,
@@ -10,6 +9,7 @@ import {
   updateIndexNowStats
 } from "../db/queries.js";
 import { logger } from "../logger.js";
+import { submitToIndexNowShared } from "./indexnow-shared.js";
 const BACKOFF_MINUTES = [5, 10, 20, 40, 60];
 async function getBackoffInfo(event) {
   const db = await useDatabase(event).catch(() => null);

package/package.json

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