@onruntime/next-sitemap 0.6.2 → 0.7.0

package/dist/pages/index.cjs

@@ -2,12 +2,10 @@
 
 var fs = require('fs');
 var path = require('path');
-var jiti = require('jiti');
-var stripJsonComments = require('strip-json-comments');
+var childProcess = require('child_process');
+var url = require('url');
 
 var _documentCurrentScript = typeof document !== 'undefined' ? document.currentScript : null;
-function _interopDefault (e) { return e && e.__esModule ? e : { default: e }; }
-
 function _interopNamespace(e) {
   if (e && e.__esModule) return e;
   var n = Object.create(null);
@@ -26,11 +24,168 @@ function _interopNamespace(e) {
   return Object.freeze(n);
 }
 
-var fs__namespace = /*#__PURE__*/_interopNamespace(fs);
-var path__namespace = /*#__PURE__*/_interopNamespace(path);
-var stripJsonComments__default = /*#__PURE__*/_interopDefault(stripJsonComments);
+var childProcess__namespace = /*#__PURE__*/_interopNamespace(childProcess);
 
 // src/pages/index.ts
+var NO_STATIC_PARAMS = "NO_STATIC_PARAMS";
+var spawnProcess = childProcess__namespace.spawn;
+var __dirname$1 = path.dirname(url.fileURLToPath((typeof document === 'undefined' ? require('u' + 'rl').pathToFileURL(__filename).href : (_documentCurrentScript && _documentCurrentScript.tagName.toUpperCase() === 'SCRIPT' && _documentCurrentScript.src || new URL('index.cjs', document.baseURI).href))));
+var paramsCache = /* @__PURE__ */ new Map();
+var isDev = process.env.NODE_ENV === "development";
+async function executeWorker(directory, fileKey, debug) {
+  const absolutePath = path.join(directory, fileKey.replace("./", ""));
+  const projectRoot = process.cwd();
+  const distRoot = path.join(__dirname$1, "..");
+  const workerPath = path.join(distRoot, "worker.cjs");
+  const loaderPath = path.join(distRoot, "loader.js");
+  if (debug) {
+    console.log(`[next-sitemap] Worker path: ${workerPath}`);
+    console.log(`[next-sitemap] Worker exists: ${fs.existsSync(workerPath)}`);
+    console.log(`[next-sitemap] Loader path: ${loaderPath}`);
+    console.log(`[next-sitemap] Loader exists: ${fs.existsSync(loaderPath)}`);
+  }
+  return new Promise((resolve) => {
+    const nodePath = [
+      path.join(projectRoot, "node_modules"),
+      path.join(__dirname$1, "..", "node_modules")
+    ].join(path.delimiter);
+    const importFlag = ["--import", loaderPath];
+    const args = [...importFlag, workerPath, absolutePath, projectRoot];
+    const child = spawnProcess("node", args, {
+      cwd: projectRoot,
+      stdio: ["ignore", "pipe", "pipe"],
+      env: { ...process.env, NODE_PATH: nodePath }
+    });
+    let stdout = "";
+    let stderr = "";
+    child.stdout.on("data", (data) => {
+      stdout += data.toString();
+    });
+    child.stderr.on("data", (data) => {
+      stderr += data.toString();
+    });
+    child.on("close", (code) => {
+      if (debug && stderr) {
+        console.warn(`[next-sitemap] Worker stderr: ${stderr}`);
+      }
+      if (code !== 0 && code !== null) {
+        if (debug) console.warn(`[next-sitemap] Worker exited with code ${code}`);
+        resolve(null);
+        return;
+      }
+      try {
+        const lines = stdout.trim().split("\n");
+        const result = JSON.parse(lines[lines.length - 1]);
+        if (result.success) {
+          resolve(result.params);
+        } else {
+          if (result.error !== NO_STATIC_PARAMS && debug) {
+            console.warn(`[next-sitemap] Worker error: ${result.error}`);
+          }
+          resolve(null);
+        }
+      } catch {
+        if (debug) console.warn(`[next-sitemap] Failed to parse worker output: ${stdout}`);
+        resolve(null);
+      }
+    });
+    child.on("error", (err) => {
+      if (debug) console.warn(`[next-sitemap] Failed to spawn worker: ${err.message}`);
+      resolve(null);
+    });
+  });
+}
+async function getRouteParams(route, directory, debug) {
+  const cacheKey = route.fileKey;
+  if (paramsCache.has(cacheKey)) {
+    return paramsCache.get(cacheKey);
+  }
+  if (debug) {
+    console.log(`[next-sitemap] ${route.pathname}: executing static params via worker`);
+  }
+  const params = await executeWorker(directory, route.fileKey, debug);
+  paramsCache.set(cacheKey, params);
+  if (debug && params) {
+    console.log(`[next-sitemap] ${route.pathname}: got ${params.length} params`);
+  }
+  return params;
+}
+async function generateAllPaths(routes, directory, debug) {
+  const staticPaths = ["/"];
+  const dynamicRoutes = [];
+  for (const route of routes) {
+    if (route.dynamicSegments.length === 0) {
+      if (route.pathname !== "/") {
+        staticPaths.push(route.pathname);
+      }
+    } else {
+      dynamicRoutes.push(route);
+    }
+  }
+  const startTime = isDev ? Date.now() : 0;
+  if (isDev && dynamicRoutes.length > 0) {
+    console.log(`[next-sitemap] Generating sitemap for ${dynamicRoutes.length} dynamic routes (dev only, instant in production)...`);
+  }
+  const dynamicResults = await Promise.all(
+    dynamicRoutes.map(async (route) => {
+      const params = await getRouteParams(route, directory, debug);
+      if (!params || params.length === 0) {
+        if (debug) {
+          console.warn(`[next-sitemap] Skipping dynamic route ${route.pathname}: no static params or empty result.`);
+        }
+        return [];
+      }
+      const paths = [];
+      for (const param of params) {
+        let path = route.pathname;
+        let valid = true;
+        for (const segment of route.dynamicSegments) {
+          const value = param[segment];
+          if (value === void 0) {
+            if (debug) {
+              console.warn(`[next-sitemap] ${route.pathname}: missing param "${segment}" in`, param);
+            }
+            valid = false;
+            break;
+          }
+          path = path.replace(`[${segment}]`, value);
+        }
+        if (valid) paths.push(path);
+      }
+      return paths;
+    })
+  );
+  const allPaths = new Set(staticPaths);
+  for (const paths of dynamicResults) {
+    for (const path of paths) {
+      allPaths.add(path);
+    }
+  }
+  if (isDev && dynamicRoutes.length > 0) {
+    const elapsed = Date.now() - startTime;
+    console.log(`[next-sitemap] Done! Found ${allPaths.size} total URLs in ${elapsed}ms.`);
+  }
+  return Array.from(allPaths);
+}
+function pathsToEntries(paths, config) {
+  const { baseUrl, locales = [], defaultLocale, exclude, priority, changeFreq } = config;
+  return paths.filter((pathname) => !shouldExclude(pathname, exclude)).map((pathname) => {
+    const entry = {
+      url: buildUrl(baseUrl, pathname, defaultLocale, defaultLocale),
+      lastModified: /* @__PURE__ */ new Date(),
+      changeFrequency: getChangeFreq(pathname, changeFreq),
+      priority: getPriority(pathname, priority)
+    };
+    if (locales.length > 0) {
+      entry.alternates = {
+        languages: Object.fromEntries(
+          locales.map((locale) => [locale, buildUrl(baseUrl, pathname, locale, defaultLocale)])
+        )
+      };
+    }
+    return entry;
+  });
+}
 
 // src/index.ts
 function calculateDepthPriority(pathname) {
@@ -171,18 +326,17 @@ function generateRobotsTxt(config) {
 }
 
 // src/pages/index.ts
-var joinPath = (...segments) => path__namespace.join(...segments);
 function findPageFiles(dir, baseDir = dir) {
   const files = [];
   try {
-    const entries = fs__namespace.readdirSync(dir, { withFileTypes: true });
+    const entries = fs.readdirSync(dir, { withFileTypes: true });
     for (const entry of entries) {
-      const fullPath = path__namespace.join(dir, entry.name);
+      const fullPath = path.join(dir, entry.name);
       if (entry.isDirectory()) {
         if (entry.name === "api") continue;
         files.push(...findPageFiles(fullPath, baseDir));
       } else if (/\.(tsx?|jsx?)$/.test(entry.name) && !entry.name.startsWith("_")) {
-        const relativePath = "./" + path__namespace.relative(baseDir, fullPath).replace(/\\/g, "/");
+        const relativePath = "./" + path.relative(baseDir, fullPath).replace(/\\/g, "/");
         files.push(relativePath);
       }
     }
@@ -190,67 +344,12 @@ function findPageFiles(dir, baseDir = dir) {
   }
   return files;
 }
-function detectPagesDirectory() {
-  const srcPages = path__namespace.join(process.cwd(), "src/pages");
-  if (fs__namespace.existsSync(srcPages)) {
-    return srcPages;
-  }
-  return path__namespace.join(process.cwd(), "pages");
-}
-function resolvePagesDirectory(options) {
-  if (options.pagesDirectory) {
-    return path__namespace.isAbsolute(options.pagesDirectory) ? options.pagesDirectory : path__namespace.join(process.cwd(), options.pagesDirectory);
+function resolvePagesDirectory(pagesDirectory) {
+  if (pagesDirectory) {
+    return path.isAbsolute(pagesDirectory) ? pagesDirectory : path.join(process.cwd(), pagesDirectory);
   }
-  return detectPagesDirectory();
-}
-function getPageKeys(options) {
-  return findPageFiles(resolvePagesDirectory(options));
-}
-var jitiCache = /* @__PURE__ */ new Map();
-function getTsconfigPaths(projectRoot) {
-  const alias = {};
-  try {
-    const tsconfigPath = path__namespace.join(projectRoot, "tsconfig.json");
-    if (fs__namespace.existsSync(tsconfigPath)) {
-      const content = fs__namespace.readFileSync(tsconfigPath, "utf-8");
-      const withoutComments = stripJsonComments__default.default(content);
-      const cleaned = withoutComments.replace(/,(\s*[}\]])/g, "$1");
-      const tsconfig = JSON.parse(cleaned);
-      const baseUrl = tsconfig.compilerOptions?.baseUrl || ".";
-      const paths = tsconfig.compilerOptions?.paths || {};
-      for (const [key, values] of Object.entries(paths)) {
-        if (values.length > 0) {
-          const aliasKey = key.replace(/\*$/, "");
-          const aliasValue = joinPath(projectRoot, baseUrl, values[0].replace(/\*$/, ""));
-          alias[aliasKey] = aliasValue;
-        }
-      }
-    }
-  } catch {
-  }
-  return alias;
-}
-function getJiti(projectRoot) {
-  if (jitiCache.has(projectRoot)) {
-    return jitiCache.get(projectRoot);
-  }
-  const alias = getTsconfigPaths(projectRoot);
-  const jiti$1 = jiti.createJiti((typeof document === 'undefined' ? require('u' + 'rl').pathToFileURL(__filename).href : (_documentCurrentScript && _documentCurrentScript.tagName.toUpperCase() === 'SCRIPT' && _documentCurrentScript.src || new URL('index.cjs', document.baseURI).href)), {
-    moduleCache: false,
-    interopDefault: true,
-    jsx: true,
-    alias
-  });
-  jitiCache.set(projectRoot, jiti$1);
-  return jiti$1;
-}
-async function importPage(pagesDirectory, key) {
-  const relativePath = key.replace("./", "");
-  const absolutePath = path__namespace.join(pagesDirectory, relativePath);
-  const projectRoot = process.cwd();
-  const jiti = getJiti(projectRoot);
-  const module = await jiti.import(absolutePath);
-  return module.default || module;
+  const srcPages = path.join(process.cwd(), "src/pages");
+  return fs.existsSync(srcPages) ? srcPages : path.join(process.cwd(), "pages");
 }
 function extractRoutes(pageKeys, localeSegment) {
   const routes = [];
@@ -259,10 +358,8 @@ function extractRoutes(pageKeys, localeSegment) {
     let pathname = key.replace(/^\.\//, "/").replace(/\.(tsx?|jsx?)$/, "").replace(/\/index$/, "/");
     if (pathname === "") pathname = "/";
     if (localeSegment) {
-      pathname = pathname.replace(
-        new RegExp(`^/${localeSegment.replace(/[[\]]/g, "\\$&")}`),
-        ""
-      );
+      const escapedSegment = localeSegment.replace(/[[\]]/g, "\\$&");
+      pathname = pathname.replace(new RegExp(`^/${escapedSegment}`), "");
     }
     if (/(?:^|\/)(src|pages)(?:\/|$)/.test(pathname)) continue;
     if (!pathname || pathname === "") {
@@ -270,160 +367,57 @@ function extractRoutes(pageKeys, localeSegment) {
     } else if (!pathname.startsWith("/")) {
       pathname = "/" + pathname;
     }
-    const dynamicSegments = pathname.match(/\[([^\]]+)\]/g)?.map((s) => s.slice(1, -1)) || [];
-    routes.push({
-      pathname,
-      dynamicSegments,
-      key
-    });
+    const dynamicSegments = pathname.match(/\[([^\]]+)\]/g)?.map((s) => s.slice(1, -1)) ?? [];
+    routes.push({ pathname, dynamicSegments, fileKey: key });
   }
   return routes;
 }
-async function getAllPaths(routes, pagesDirectory, debug = false) {
-  const allPaths = ["/"];
-  const seenPaths = /* @__PURE__ */ new Set(["/"]);
-  for (const route of routes) {
-    if (route.dynamicSegments.length === 0) {
-      if (route.pathname !== "/" && !seenPaths.has(route.pathname)) {
-        allPaths.push(route.pathname);
-        seenPaths.add(route.pathname);
-      }
-    } else {
-      let getParams = null;
-      try {
-        if (debug) {
-          console.log(`[next-sitemap] ${route.pathname}: importing ${route.key}`);
-        }
-        const module = await importPage(pagesDirectory, route.key);
-        const getStaticPaths = module.getStaticPaths;
-        if (getStaticPaths) {
-          getParams = async () => {
-            const result = await getStaticPaths();
-            return result.paths.map((p) => p.params);
-          };
-        } else if (module.generateStaticParams) {
-          getParams = module.generateStaticParams;
-        }
-      } catch (error) {
-        if (debug) {
-          console.warn(`[next-sitemap] ${route.pathname}: import failed:`, error);
-        }
-      }
-      if (getParams) {
-        try {
-          const params = await getParams();
-          if (debug) {
-            console.log(`[next-sitemap] ${route.pathname}: getStaticPaths returned ${params.length} params`);
-          }
-          for (const param of params) {
-            let dynamicPath = route.pathname;
-            for (const segment of route.dynamicSegments) {
-              const value = param[segment];
-              if (value === void 0) {
-                if (debug) {
-                  console.warn(`[next-sitemap] ${route.pathname}: missing param "${segment}" in`, param);
-                }
-                continue;
-              }
-              dynamicPath = dynamicPath.replace(`[${segment}]`, value);
-            }
-            if (!seenPaths.has(dynamicPath)) {
-              allPaths.push(dynamicPath);
-              seenPaths.add(dynamicPath);
-            }
-          }
-        } catch (error) {
-          console.error(`[next-sitemap] Error calling getStaticPaths for ${route.pathname}:`, error);
-        }
-      } else {
-        if (debug) {
-          console.warn(
-            `[next-sitemap] Skipping dynamic route ${route.pathname}: no getStaticPaths exported. Use additionalSitemaps for routes that fetch data at runtime.`
-          );
-        }
-      }
-    }
-  }
-  return allPaths;
-}
-function pathsToEntries(paths, config) {
-  const { baseUrl, locales = [], defaultLocale, exclude, priority, changeFreq } = config;
-  const filteredPaths = paths.filter((pathname) => !shouldExclude(pathname, exclude));
-  return filteredPaths.map((pathname) => {
-    const entry = {
-      url: buildUrl(baseUrl, pathname, defaultLocale, defaultLocale),
-      lastModified: /* @__PURE__ */ new Date(),
-      changeFrequency: getChangeFreq(pathname, changeFreq),
-      priority: getPriority(pathname, priority)
-    };
-    if (locales.length > 0) {
-      entry.alternates = {
-        languages: Object.fromEntries(
-          locales.map((locale) => [
-            locale,
-            buildUrl(baseUrl, pathname, locale, defaultLocale)
-          ])
-        )
-      };
-    }
-    return entry;
-  });
-}
 function createSitemapIndexApiHandler(options) {
   const { urlsPerSitemap = 5e3, additionalSitemaps, exclude, debug = false } = options;
   const localeSegment = options.localeSegment ?? "";
-  const pagesDir = resolvePagesDirectory(options);
-  const pageKeys = getPageKeys(options);
+  const pagesDir = resolvePagesDirectory(options.pagesDirectory);
+  const pageKeys = findPageFiles(pagesDir);
   const routes = extractRoutes(pageKeys, localeSegment);
-  if (debug) {
-    console.log(`[next-sitemap] Found ${routes.length} routes:`);
-    routes.forEach((r) => {
-      const isDynamic = r.dynamicSegments.length > 0;
-      const segments = isDynamic ? ` [${r.dynamicSegments.join(", ")}]` : "";
-      console.log(`  ${r.pathname}${segments}${isDynamic ? " (dynamic)" : ""}`);
-    });
-  }
   return async function handler(_req, res) {
-    const allPaths = await getAllPaths(routes, pagesDir, debug);
-    const filteredPaths = allPaths.filter((pathname) => !shouldExclude(pathname, exclude));
+    if (debug) {
+      console.log(`[next-sitemap] Found ${routes.length} routes`);
+    }
+    const allPaths = await generateAllPaths(routes, pagesDir, debug);
+    const filteredPaths = allPaths.filter((p) => !shouldExclude(p, exclude));
     const sitemapCount = Math.max(1, Math.ceil(filteredPaths.length / urlsPerSitemap));
-    const xml = generateSitemapIndexXml(options.baseUrl, sitemapCount, {
-      additionalSitemaps
-    });
     res.setHeader("Content-Type", "application/xml");
-    res.status(200).send(xml);
+    res.status(200).send(
+      generateSitemapIndexXml(options.baseUrl, sitemapCount, { additionalSitemaps })
+    );
   };
 }
 function createSitemapApiHandler(options) {
   const { urlsPerSitemap = 5e3, exclude, debug = false } = options;
   const localeSegment = options.localeSegment ?? "";
-  const pagesDir = resolvePagesDirectory(options);
-  const pageKeys = getPageKeys(options);
+  const pagesDir = resolvePagesDirectory(options.pagesDirectory);
+  const pageKeys = findPageFiles(pagesDir);
   const routes = extractRoutes(pageKeys, localeSegment);
   const getFilteredPaths = async () => {
-    const allPaths = await getAllPaths(routes, pagesDir, debug);
-    return allPaths.filter((pathname) => !shouldExclude(pathname, exclude));
+    const allPaths = await generateAllPaths(routes, pagesDir, debug);
+    return allPaths.filter((p) => !shouldExclude(p, exclude));
   };
   return async function handler(req, res) {
     const { id } = req.query;
     const sitemapId = parseInt(Array.isArray(id) ? id[0] : id || "0", 10);
     const filteredPaths = await getFilteredPaths();
-    const start = sitemapId * urlsPerSitemap;
-    const end = start + urlsPerSitemap;
-    const paths = filteredPaths.slice(start, end);
+    const paths = filteredPaths.slice(sitemapId * urlsPerSitemap, (sitemapId + 1) * urlsPerSitemap);
     const entries = pathsToEntries(paths, { ...options, exclude: void 0 });
-    const xml = generateSitemapXml(entries);
     res.setHeader("Content-Type", "application/xml");
-    res.status(200).send(xml);
+    res.status(200).send(generateSitemapXml(entries));
   };
 }
 async function getSitemapStaticPaths(options) {
   const { urlsPerSitemap = 5e3, exclude, debug = false } = options;
   const localeSegment = options.localeSegment ?? "";
-  const pagesDir = resolvePagesDirectory(options);
-  const pageKeys = getPageKeys(options);
+  const pagesDir = resolvePagesDirectory(options.pagesDirectory);
+  const pageKeys = findPageFiles(pagesDir);
   const routes = extractRoutes(pageKeys, localeSegment);
-  const allPaths = await getAllPaths(routes, pagesDir, debug);
+  const allPaths = await generateAllPaths(routes, pagesDir, debug);
   const filteredPaths = allPaths.filter((pathname) => !shouldExclude(pathname, exclude));
   const sitemapCount = Math.max(1, Math.ceil(filteredPaths.length / urlsPerSitemap));
   return {
@@ -435,9 +429,8 @@ async function getSitemapStaticPaths(options) {
 }
 function createRobotsApiHandler(config) {
   return function handler(_req, res) {
-    const robotsTxt = generateRobotsTxt(config);
     res.setHeader("Content-Type", "text/plain");
-    res.status(200).send(robotsTxt);
+    res.status(200).send(generateRobotsTxt(config));
   };
 }
 

package/dist/pages/index.d.cts

@@ -2,6 +2,7 @@ import { MetadataRoute, NextApiRequest, NextApiResponse } from 'next';
 export { MetadataRoute } from 'next';
 
 type ChangeFrequency = "always" | "hourly" | "daily" | "weekly" | "monthly" | "yearly" | "never";
+
 interface SitemapConfig {
     /**
      * Base URL of the site (e.g., "https://example.com")
@@ -54,6 +55,11 @@ interface SitemapConfig {
      * @example additionalSitemaps: ["/products-sitemap.xml", "/blog-sitemap.xml"]
      */
     additionalSitemaps?: string[];
+    /**
+     * Enable debug logging to diagnose issues with route discovery
+     * @default false
+     */
+    debug?: boolean;
 }
 interface SitemapEntry {
     url: string;
@@ -76,28 +82,17 @@ interface CreateSitemapApiHandlerOptions extends SitemapConfig {
      * Path to the pages directory to scan for page files.
      * Can be absolute or relative to process.cwd().
      * If not provided, auto-detects src/pages or pages.
-     *
-     * Example:
-     * ```ts
-     * pagesDirectory: 'src/pages'
-     * ```
      */
     pagesDirectory?: string;
-    /**
-     * Enable debug logging to diagnose issues with route discovery
-     * Logs info about getStaticPaths calls and skipped routes
-     * @default false
-     */
-    debug?: boolean;
 }
 /**
  * Create API handler for sitemap index route
- * Use in: pages/api/sitemap.xml.ts or pages/sitemap.xml.ts (with rewrites)
+ * Use in: pages/api/sitemap.xml.ts
  */
 declare function createSitemapIndexApiHandler(options: CreateSitemapApiHandlerOptions): (_req: NextApiRequest, res: NextApiResponse) => Promise<void>;
 /**
  * Create API handler for individual sitemap routes
- * Use in: pages/api/sitemap/[id].ts or pages/sitemap-[id].xml.ts (with rewrites)
+ * Use in: pages/api/sitemap/[id].ts
  */
 declare function createSitemapApiHandler(options: CreateSitemapApiHandlerOptions): (req: NextApiRequest, res: NextApiResponse) => Promise<void>;
 /**
@@ -114,20 +109,7 @@ declare function getSitemapStaticPaths(options: CreateSitemapApiHandlerOptions):
 }>;
 /**
  * Create API handler for robots.txt
- * Use in: pages/api/robots.txt.ts or pages/robots.txt.ts (with rewrites)
- *
- * @example
- * // pages/api/robots.txt.ts
- * import { createRobotsApiHandler } from "@onruntime/next-sitemap/pages";
- *
- * export default createRobotsApiHandler({
- *   rules: {
- *     userAgent: "*",
- *     allow: "/",
- *     disallow: ["/admin", "/private"],
- *   },
- *   sitemap: "https://example.com/sitemap.xml",
- * });
+ * Use in: pages/api/robots.txt.ts
  */
 declare function createRobotsApiHandler(config: MetadataRoute.Robots): (_req: NextApiRequest, res: NextApiResponse) => void;
 

package/dist/pages/index.d.ts

@@ -2,6 +2,7 @@ import { MetadataRoute, NextApiRequest, NextApiResponse } from 'next';
 export { MetadataRoute } from 'next';
 
 type ChangeFrequency = "always" | "hourly" | "daily" | "weekly" | "monthly" | "yearly" | "never";
+
 interface SitemapConfig {
     /**
      * Base URL of the site (e.g., "https://example.com")
@@ -54,6 +55,11 @@ interface SitemapConfig {
      * @example additionalSitemaps: ["/products-sitemap.xml", "/blog-sitemap.xml"]
      */
     additionalSitemaps?: string[];
+    /**
+     * Enable debug logging to diagnose issues with route discovery
+     * @default false
+     */
+    debug?: boolean;
 }
 interface SitemapEntry {
     url: string;
@@ -76,28 +82,17 @@ interface CreateSitemapApiHandlerOptions extends SitemapConfig {
      * Path to the pages directory to scan for page files.
      * Can be absolute or relative to process.cwd().
      * If not provided, auto-detects src/pages or pages.
-     *
-     * Example:
-     * ```ts
-     * pagesDirectory: 'src/pages'
-     * ```
      */
     pagesDirectory?: string;
-    /**
-     * Enable debug logging to diagnose issues with route discovery
-     * Logs info about getStaticPaths calls and skipped routes
-     * @default false
-     */
-    debug?: boolean;
 }
 /**
  * Create API handler for sitemap index route
- * Use in: pages/api/sitemap.xml.ts or pages/sitemap.xml.ts (with rewrites)
+ * Use in: pages/api/sitemap.xml.ts
  */
 declare function createSitemapIndexApiHandler(options: CreateSitemapApiHandlerOptions): (_req: NextApiRequest, res: NextApiResponse) => Promise<void>;
 /**
  * Create API handler for individual sitemap routes
- * Use in: pages/api/sitemap/[id].ts or pages/sitemap-[id].xml.ts (with rewrites)
+ * Use in: pages/api/sitemap/[id].ts
  */
 declare function createSitemapApiHandler(options: CreateSitemapApiHandlerOptions): (req: NextApiRequest, res: NextApiResponse) => Promise<void>;
 /**
@@ -114,20 +109,7 @@ declare function getSitemapStaticPaths(options: CreateSitemapApiHandlerOptions):
 }>;
 /**
  * Create API handler for robots.txt
- * Use in: pages/api/robots.txt.ts or pages/robots.txt.ts (with rewrites)
- *
- * @example
- * // pages/api/robots.txt.ts
- * import { createRobotsApiHandler } from "@onruntime/next-sitemap/pages";
- *
- * export default createRobotsApiHandler({
- *   rules: {
- *     userAgent: "*",
- *     allow: "/",
- *     disallow: ["/admin", "/private"],
- *   },
- *   sitemap: "https://example.com/sitemap.xml",
- * });
+ * Use in: pages/api/robots.txt.ts
  */
 declare function createRobotsApiHandler(config: MetadataRoute.Robots): (_req: NextApiRequest, res: NextApiResponse) => void;