geo-ai-next 0.1.1 → 0.2.0

package/README.md

@@ -2,9 +2,11 @@
 
 [![npm](https://img.shields.io/npm/v/geo-ai-next)](https://npmjs.com/package/geo-ai-next)
 
-Part of the [GEO AI ecosystem](https://github.com/madeburo/GEO-AI). Full documentation → [geo-ai-core](https://npmjs.com/package/geo-ai-core)
+Part of the [GEO AI – AI Search Optimization](https://www.geoai.run) ecosystem. [GitHub](https://github.com/madeburo/GEO-AI)
 
-Thin Next.js wrapper for [geo-ai-core](../core) — middleware and App Router route handler for serving `llms.txt` / `llms-full.txt`.
+Next.js integration for [geo-ai-core](https://npmjs.com/package/geo-ai-core) — static file generation, middleware, and App Router route handler for `llms.txt` / `llms-full.txt`.
+
+Try the analyzer at [geoai.run/analyze](https://www.geoai.run/analyze)
 
 ## Installation
 
@@ -14,9 +16,237 @@ npm install geo-ai-next
 
 Peer dependency: `next >= 16`
 
+---
+
+## Recommended Production Setup
+
+The shortest path to working GEO AI files in production:
+
+**1.** Create `geo-ai.config.mjs` in your project root
+**2.** Add the build script to `package.json`
+**3.** Run `npm run build` — files appear in `public/`
+**4.** Deploy — done
+
+```json
+{
+  "scripts": {
+    "geo:generate": "geo-ai-generate",
+    "build": "npm run geo:generate && next build"
+  }
+}
+```
+
+```js
+// geo-ai.config.mjs
+export default {
+  siteName: 'My Site',
+  siteUrl: 'https://example.com',
+  provider: { Pages: [{ title: 'Home', url: '/', description: 'Welcome' }] },
+  crawlers: 'all',
+};
+```
+
+After build, verify:
+```bash
+ls public/llms.txt public/llms-full.txt  # both files present
+```
+
+Full details and options in the sections below.
+
+---
+
+## llms.txt vs llms-full.txt
+
+Both files follow the [llms.txt standard](https://llmstxt.org) for making site content readable by AI search engines.
+
+| File | Purpose | Content |
+|------|---------|---------|
+| `llms.txt` | Concise index for AI crawlers | Site name, description, crawler rules, resource list with titles, URLs, and short descriptions |
+| `llms-full.txt` | Extended version for deep indexing | Everything in `llms.txt` plus full page content, product pricing, availability, and variants |
+
+AI crawlers like GPTBot and ClaudeBot discover `llms.txt` first. If they need more detail — for example to answer a product question — they fetch `llms-full.txt`. Serving both maximizes your site's visibility in AI search results.
+
+---
+
+## Static File Generation (Recommended)
+
+The most reliable approach for production. Generates `public/llms.txt` and `public/llms-full.txt` as static files before `next build` — Next.js serves them automatically, no middleware needed.
+
+```typescript
+// scripts/generate-llms.ts
+import { generateLlmsFiles } from 'geo-ai-next';
+
+await generateLlmsFiles({
+  siteName: 'My Site',
+  siteUrl: 'https://example.com',
+  siteDescription: 'AI-optimized site description',
+  provider: {
+    Pages: [
+      { title: 'Home', url: '/', description: 'Welcome page' },
+      { title: 'About', url: '/about', description: 'About us' },
+    ],
+    Products: [
+      { title: 'Widget', url: '/products/widget', description: 'A great widget', price: '$29' },
+    ],
+  },
+  crawlers: 'all',
+});
+```
+
+Add to `package.json`:
+
+```json
+{
+  "scripts": {
+    "geo:generate": "geo-ai-generate",
+    "build": "npm run geo:generate && next build"
+  }
+}
+```
+
+After `npm run build`, both files are written to `public/` and served at:
+- `https://yoursite.com/llms.txt`
+- `https://yoursite.com/llms-full.txt`
+
+### Options
+
+| Option | Type | Default | Description |
+|--------|------|---------|-------------|
+| `outDir` | `string` | `'public'` | Output directory (relative to cwd) |
+| `locale` | `string` | — | Locale for content generation |
+| + all `GeoAIConfig` options | | | `siteName`, `siteUrl`, `provider`, `crawlers`, `cache`, etc. |
+
+### CLI
+
+The `geo-ai-generate` binary is included in the package. It reads `geo-ai.config.mjs` from your project root by default.
+
+```bash
+# Run directly (reads geo-ai.config.mjs)
+npx geo-ai-generate
+
+# Custom config path
+npx geo-ai-generate --config ./config/geo-ai.mjs
+```
+
+Example `geo-ai.config.mjs`:
+
+```js
+// geo-ai.config.mjs
+export default {
+  siteName: 'My Site',
+  siteUrl: 'https://example.com',
+  provider: {
+    Pages: [
+      { title: 'Home', url: '/', description: 'Welcome' },
+      { title: 'About', url: '/about', description: 'About us' },
+    ],
+  },
+  crawlers: 'all',
+};
+```
+
+With this config file in place, your `package.json` scripts become:
+
+```json
+{
+  "scripts": {
+    "geo:generate": "geo-ai-generate",
+    "build": "npm run geo:generate && next build"
+  }
+}
+```
+
+### Troubleshooting: 404 on `/llms.txt`
+
+1. Make sure `generateLlmsFiles()` runs before `next build`
+2. Check that `public/llms.txt` exists after generation
+3. Vercel and Netlify serve `public/` automatically — no extra config needed
+4. For custom servers, ensure static file serving is configured for the `public/` directory
+
+---
+
+## End-to-End Example
+
+Minimal Next.js app that generates and serves both files:
+
+**1. Install**
+```bash
+npm install geo-ai-next
+```
+
+**2. Create `geo-ai.config.mjs`**
+```js
+export default {
+  siteName: 'Acme Store',
+  siteUrl: 'https://acme.example.com',
+  siteDescription: 'Quality widgets for every need',
+  provider: {
+    Pages: [
+      { title: 'Home', url: '/', description: 'Welcome to Acme Store' },
+      { title: 'About', url: '/about', description: 'Our story' },
+    ],
+    Products: [
+      {
+        title: 'Classic Widget',
+        url: '/products/classic',
+        description: 'Our best-selling widget',
+        price: '$29.99',
+        available: true,
+      },
+    ],
+  },
+  crawlers: 'all',
+};
+```
+
+**3. Add scripts to `package.json`**
+```json
+{
+  "scripts": {
+    "geo:generate": "geo-ai-generate",
+    "build": "npm run geo:generate && next build"
+  }
+}
+```
+
+**4. Run build**
+```bash
+npm run build
+```
+
+Output:
+```
+[geo-ai] Generating llms files → /your-project/public
+[geo-ai] ✓ /your-project/public/llms.txt (843 bytes)
+[geo-ai] ✓ /your-project/public/llms-full.txt (1204 bytes)
+[geo-ai] Done.
+```
+
+**5. Verify**
+```bash
+curl https://acme.example.com/llms.txt
+curl https://acme.example.com/llms-full.txt
+```
+
+Both return `200 OK` with `text/plain` content — no middleware, no route handler needed.
+
+---
+
+## Runtime Serving (Alternative)
+
+If you were already using middleware or a route handler, they continue to work. Static generation is the recommended production approach, but runtime serving is still valid for dynamic use cases like per-request locale or content that changes too frequently to regenerate at build time.
+
+| Approach | When to use |
+|----------|-------------|
+| Static generation (`generateLlmsFiles`) | Production default — works on Vercel, Netlify, any static host |
+| Middleware (`geoAIMiddleware`) | Dynamic content per-request, edge locale detection |
+| Route handler (`createLlmsHandler`) | Custom route path, App Router, programmatic control |
+
+---
+
 ## Middleware
 
-Intercepts `/llms.txt` and `/llms-full.txt` requests, passes everything else through:
+Intercepts `/llms.txt` and `/llms-full.txt` at the edge, passes everything else through. Use this when you need dynamic content per-request (e.g. locale from cookies, A/B testing).
 
 ```typescript
 // middleware.ts
@@ -27,7 +257,7 @@ export default geoAIMiddleware({
   siteUrl: 'https://example.com',
   provider: new MyProvider(),
   cache: '24h',
-  cacheMaxAge: 3600,    // Cache-Control max-age in seconds (default 3600)
+  cacheMaxAge: 3600,      // Cache-Control max-age in seconds (default 3600)
   injectLinkHeader: true, // adds Link header to all responses
 });
 
@@ -36,9 +266,11 @@ export const config = {
 };
 ```
 
+---
+
 ## Route Handler
 
-For App Router — serves llms content at any route you choose:
+For App Router — serves llms content at a custom route. File type is determined by URL path (`/llms-full.txt`) or query param `?type=full`.
 
 ```typescript
 // app/llms/route.ts
@@ -48,15 +280,15 @@ export const { GET } = createLlmsHandler({
   siteName: 'My Site',
   siteUrl: 'https://example.com',
   provider: new MyProvider(),
-  cacheMaxAge: 7200, // optional, default 3600
+  cacheMaxAge: 3600, // optional, default 3600
 });
 ```
 
-Type is determined by URL path (`/llms-full.txt`) or query param `?type=full`.
+---
 
 ## Re-exports
 
-All public API from `geo-ai-core` is re-exported, so you don't need to install both:
+All public API from `geo-ai-core` is re-exported — no need to install both packages:
 
 ```typescript
 import {
@@ -67,9 +299,12 @@ import {
   AI_BOTS,
   type ContentProvider,
   type Resource,
+  type GeoAIConfig,
 } from 'geo-ai-next';
 ```
 
+---
+
 ## Requirements
 
 - Node.js >= 20

package/dist/cli.mjs

@@ -0,0 +1,102 @@
+#!/usr/bin/env node
+var __defProp = Object.defineProperty;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __esm = (fn, res) => function __init() {
+  return fn && (res = (0, fn[__getOwnPropNames(fn)[0]])(fn = 0)), res;
+};
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+
+// src/generate.ts
+var generate_exports = {};
+__export(generate_exports, {
+  generateLlmsFiles: () => generateLlmsFiles
+});
+import { createGeoAI } from "geo-ai-core";
+import { writeFile, mkdir } from "fs/promises";
+import { join, resolve } from "path";
+async function generateLlmsFiles(config) {
+  const outDir = resolve(config.outDir ?? "public");
+  console.log(`[geo-ai] Generating llms files \u2192 ${outDir}`);
+  const core = createGeoAI(config);
+  await mkdir(outDir, { recursive: true });
+  const [llmsContent, llmsFullContent] = await Promise.all([
+    core.generateLlms(false, config.locale),
+    core.generateLlms(true, config.locale)
+  ]);
+  const llmsPath = join(outDir, "llms.txt");
+  const llmsFullPath = join(outDir, "llms-full.txt");
+  const tmpLlms = `${llmsPath}.tmp`;
+  const tmpFull = `${llmsFullPath}.tmp`;
+  try {
+    await Promise.all([
+      writeFile(tmpLlms, llmsContent, "utf-8"),
+      writeFile(tmpFull, llmsFullContent, "utf-8")
+    ]);
+    const { rename } = await import("fs/promises");
+    await Promise.all([
+      rename(tmpLlms, llmsPath),
+      rename(tmpFull, llmsFullPath)
+    ]);
+  } catch (err) {
+    const { unlink } = await import("fs/promises");
+    await unlink(tmpLlms).catch(() => {
+    });
+    await unlink(tmpFull).catch(() => {
+    });
+    throw err;
+  }
+  console.log(`[geo-ai] \u2713 ${llmsPath} (${llmsContent.length} bytes)`);
+  console.log(`[geo-ai] \u2713 ${llmsFullPath} (${llmsFullContent.length} bytes)`);
+  return { llmsPath, llmsFullPath };
+}
+var init_generate = __esm({
+  "src/generate.ts"() {
+    "use strict";
+  }
+});
+
+// src/cli.ts
+import { resolve as resolve2 } from "path";
+import { pathToFileURL } from "url";
+async function main() {
+  const args = process.argv.slice(2);
+  let configPath = resolve2("geo-ai.config.ts");
+  const configIdx = args.indexOf("--config");
+  if (configIdx !== -1 && args[configIdx + 1]) {
+    configPath = resolve2(args[configIdx + 1]);
+  }
+  let config;
+  try {
+    const mod = await import(pathToFileURL(configPath).href);
+    config = mod.default ?? mod;
+  } catch {
+    const jsPath = configPath.replace(/\.ts$/, ".mjs");
+    try {
+      const mod = await import(pathToFileURL(jsPath).href);
+      config = mod.default ?? mod;
+    } catch {
+      console.error(`[geo-ai] Could not load config from ${configPath}`);
+      console.error(`[geo-ai] Create a geo-ai.config.ts (or .mjs) file in your project root.`);
+      console.error(`[geo-ai] Example:
+`);
+      console.error(`  import type { GenerateLlmsFilesConfig } from 'geo-ai-next';`);
+      console.error(`  export default {`);
+      console.error(`    siteName: 'My Site',`);
+      console.error(`    siteUrl: 'https://example.com',`);
+      console.error(`    provider: { Pages: [{ title: 'Home', url: '/' }] },`);
+      console.error(`  } satisfies GenerateLlmsFilesConfig;
+`);
+      process.exit(1);
+    }
+  }
+  const { generateLlmsFiles: generateLlmsFiles2 } = await Promise.resolve().then(() => (init_generate(), generate_exports));
+  await generateLlmsFiles2(config);
+  console.log("[geo-ai] Done.");
+}
+main().catch((err) => {
+  console.error("[geo-ai] Generation failed:", err);
+  process.exit(1);
+});

package/dist/index.cjs

@@ -1,7 +1,9 @@
 "use strict";
+var __create = Object.create;
 var __defProp = Object.defineProperty;
 var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
 var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
 var __hasOwnProp = Object.prototype.hasOwnProperty;
 var __export = (target, all) => {
   for (var name in all)
@@ -15,22 +17,31 @@ var __copyProps = (to, from, except, desc) => {
   }
   return to;
 };
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
+  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
+  mod
+));
 var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
 
 // src/index.ts
 var src_exports = {};
 __export(src_exports, {
-  AI_BOTS: () => import_geo_ai_core3.AI_BOTS,
-  BotRulesEngine: () => import_geo_ai_core3.BotRulesEngine,
-  CrawlTracker: () => import_geo_ai_core3.CrawlTracker,
-  CryptoService: () => import_geo_ai_core3.CryptoService,
-  FileCacheAdapter: () => import_geo_ai_core3.FileCacheAdapter,
-  LlmsGenerator: () => import_geo_ai_core3.LlmsGenerator,
-  MemoryCacheAdapter: () => import_geo_ai_core3.MemoryCacheAdapter,
-  MemoryCrawlStore: () => import_geo_ai_core3.MemoryCrawlStore,
-  SeoGenerator: () => import_geo_ai_core3.SeoGenerator,
-  createGeoAI: () => import_geo_ai_core3.createGeoAI,
+  AI_BOTS: () => import_geo_ai_core4.AI_BOTS,
+  BotRulesEngine: () => import_geo_ai_core4.BotRulesEngine,
+  CrawlTracker: () => import_geo_ai_core4.CrawlTracker,
+  CryptoService: () => import_geo_ai_core4.CryptoService,
+  FileCacheAdapter: () => import_geo_ai_core4.FileCacheAdapter,
+  LlmsGenerator: () => import_geo_ai_core4.LlmsGenerator,
+  MemoryCacheAdapter: () => import_geo_ai_core4.MemoryCacheAdapter,
+  MemoryCrawlStore: () => import_geo_ai_core4.MemoryCrawlStore,
+  SeoGenerator: () => import_geo_ai_core4.SeoGenerator,
+  createGeoAI: () => import_geo_ai_core4.createGeoAI,
   createLlmsHandler: () => createLlmsHandler,
+  generateLlmsFiles: () => generateLlmsFiles,
   geoAIMiddleware: () => geoAIMiddleware
 });
 module.exports = __toCommonJS(src_exports);
@@ -102,8 +113,48 @@ function createLlmsHandler(config) {
   };
 }
 
-// src/index.ts
+// src/generate.ts
 var import_geo_ai_core3 = require("geo-ai-core");
+var import_promises = require("fs/promises");
+var import_node_path = require("path");
+async function generateLlmsFiles(config) {
+  const outDir = (0, import_node_path.resolve)(config.outDir ?? "public");
+  console.log(`[geo-ai] Generating llms files \u2192 ${outDir}`);
+  const core = (0, import_geo_ai_core3.createGeoAI)(config);
+  await (0, import_promises.mkdir)(outDir, { recursive: true });
+  const [llmsContent, llmsFullContent] = await Promise.all([
+    core.generateLlms(false, config.locale),
+    core.generateLlms(true, config.locale)
+  ]);
+  const llmsPath = (0, import_node_path.join)(outDir, "llms.txt");
+  const llmsFullPath = (0, import_node_path.join)(outDir, "llms-full.txt");
+  const tmpLlms = `${llmsPath}.tmp`;
+  const tmpFull = `${llmsFullPath}.tmp`;
+  try {
+    await Promise.all([
+      (0, import_promises.writeFile)(tmpLlms, llmsContent, "utf-8"),
+      (0, import_promises.writeFile)(tmpFull, llmsFullContent, "utf-8")
+    ]);
+    const { rename } = await import("fs/promises");
+    await Promise.all([
+      rename(tmpLlms, llmsPath),
+      rename(tmpFull, llmsFullPath)
+    ]);
+  } catch (err) {
+    const { unlink } = await import("fs/promises");
+    await unlink(tmpLlms).catch(() => {
+    });
+    await unlink(tmpFull).catch(() => {
+    });
+    throw err;
+  }
+  console.log(`[geo-ai] \u2713 ${llmsPath} (${llmsContent.length} bytes)`);
+  console.log(`[geo-ai] \u2713 ${llmsFullPath} (${llmsFullContent.length} bytes)`);
+  return { llmsPath, llmsFullPath };
+}
+
+// src/index.ts
+var import_geo_ai_core4 = require("geo-ai-core");
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   AI_BOTS,
@@ -117,6 +168,7 @@ var import_geo_ai_core3 = require("geo-ai-core");
   SeoGenerator,
   createGeoAI,
   createLlmsHandler,
+  generateLlmsFiles,
   geoAIMiddleware
 });
 //# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/index.ts","../src/middleware.ts","../src/handler.ts"],"sourcesContent":["// geo-ai-next main entry point\n\n// Next.js middleware\nexport { geoAIMiddleware } from './middleware';\nexport type { GeoAIMiddlewareConfig } from './middleware';\n\n// Next.js route handler\nexport { createLlmsHandler } from './handler';\nexport type { LlmsHandlerConfig } from './handler';\n\n// Re-export all public types, interfaces, and classes from geo-ai-core\nexport {\n  createGeoAI,\n  MemoryCacheAdapter,\n  FileCacheAdapter,\n  CrawlTracker,\n  MemoryCrawlStore,\n  CryptoService,\n  BotRulesEngine,\n  AI_BOTS,\n  SeoGenerator,\n  LlmsGenerator,\n} from 'geo-ai-core';\n\nexport type {\n  GeoAIInstance,\n  Resource,\n  ProductResource,\n  ResourceSection,\n  ContentProvider,\n  CacheAdapter,\n  CrawlEntry,\n  CrawlActivity,\n  CrawlStore,\n  CrawlTrackingConfig,\n  CryptoConfig,\n  GeoAIConfig,\n  AiProvider,\n  AiGeneratorConfig,\n  AiError,\n  AiBulkConfig,\n  AiContext,\n} from 'geo-ai-core';\n","import { NextResponse } from 'next/server';\nimport type { NextRequest } from 'next/server';\nimport { createGeoAI } from 'geo-ai-core';\nimport type { GeoAIConfig, GeoAIInstance } from 'geo-ai-core';\n\n// ── Config ──────────────────────────────────────────────────────────\n\nexport interface GeoAIMiddlewareConfig extends GeoAIConfig {\n  /** Inject Link header pointing to llms.txt on non-llms responses. Default: false */\n  injectLinkHeader?: boolean;\n  /** Cache-Control max-age in seconds for llms.txt responses. Default: 3600 */\n  cacheMaxAge?: number;\n}\n\n// ── Middleware factory ───────────────────────────────────────────────\n\n/**\n * Creates a Next.js middleware function that intercepts `/llms.txt` and\n * `/llms-full.txt` requests, returning generated content as `text/plain`.\n * All other paths are passed through via `NextResponse.next()`.\n */\nexport function geoAIMiddleware(\n  config: GeoAIMiddlewareConfig,\n): (request: NextRequest) => Promise<NextResponse> {\n  const core: GeoAIInstance = createGeoAI(config);\n  const injectLink = config.injectLinkHeader ?? false;\n  const maxAge = config.cacheMaxAge ?? 3600;\n\n  return async (request: NextRequest): Promise<NextResponse> => {\n    const { pathname } = request.nextUrl;\n\n    // ── Match llms paths ───────────────────────────────────────────\n    if (pathname === '/llms.txt' || pathname === '/llms-full.txt') {\n      const isFull = pathname === '/llms-full.txt';\n\n      try {\n        const content = await core.generateLlms(isFull);\n\n        // Fire-and-forget: track visit without blocking the response\n        core.trackVisit(request as unknown as Request).catch(() => {});\n\n        return new NextResponse(content, {\n          status: 200,\n          headers: {\n            'Content-Type': 'text/plain; charset=utf-8',\n            'Cache-Control': `public, max-age=${maxAge}`,\n          },\n        });\n      } catch {\n        return new NextResponse('Internal Server Error', {\n          status: 500,\n          headers: { 'Content-Type': 'text/plain; charset=utf-8' },\n        });\n      }\n    }\n\n    // ── Passthrough ────────────────────────────────────────────────\n    const response = NextResponse.next();\n\n    if (injectLink) {\n      response.headers.set('Link', core.generateLinkHeader());\n    }\n\n    return response;\n  };\n}\n","import { createGeoAI } from 'geo-ai-core';\nimport type { GeoAIConfig, GeoAIInstance } from 'geo-ai-core';\n\n// ── Config ──────────────────────────────────────────────────────────\n\nexport interface LlmsHandlerConfig extends GeoAIConfig {\n  /** Cache-Control max-age in seconds for llms.txt responses. Default: 3600 */\n  cacheMaxAge?: number;\n}\n\n// ── Route Handler factory ───────────────────────────────────────────\n\n/**\n * Creates a Next.js App Router route handler that serves llms.txt content.\n * File type is determined by URL path (`/llms-full.txt`) or query `?type=full`.\n *\n * Usage in `app/llms/route.ts`:\n * ```ts\n * export const { GET } = createLlmsHandler({ ... });\n * ```\n */\nexport function createLlmsHandler(config: LlmsHandlerConfig): {\n  GET: (request: Request) => Promise<Response>;\n} {\n  const core: GeoAIInstance = createGeoAI(config);\n  const maxAge = config.cacheMaxAge ?? 3600;\n\n  return {\n    async GET(request: Request): Promise<Response> {\n      const url = new URL(request.url);\n      const isFull =\n        url.pathname.endsWith('/llms-full.txt') ||\n        url.searchParams.get('type') === 'full';\n\n      try {\n        const content = await core.generateLlms(isFull);\n\n        // Fire-and-forget: log bot visit without blocking the response\n        core.trackVisit(request).catch(() => {});\n\n        return new Response(content, {\n          status: 200,\n          headers: {\n            'Content-Type': 'text/plain; charset=utf-8',\n            'Cache-Control': `public, max-age=${maxAge}`,\n          },\n        });\n      } catch {\n        return new Response('Internal Server Error', {\n          status: 500,\n          headers: { 'Content-Type': 'text/plain; charset=utf-8' },\n        });\n      }\n    },\n  };\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;;;ACAA,oBAA6B;AAE7B,yBAA4B;AAmBrB,SAAS,gBACd,QACiD;AACjD,QAAM,WAAsB,gCAAY,MAAM;AAC9C,QAAM,aAAa,OAAO,oBAAoB;AAC9C,QAAM,SAAS,OAAO,eAAe;AAErC,SAAO,OAAO,YAAgD;AAC5D,UAAM,EAAE,SAAS,IAAI,QAAQ;AAG7B,QAAI,aAAa,eAAe,aAAa,kBAAkB;AAC7D,YAAM,SAAS,aAAa;AAE5B,UAAI;AACF,cAAM,UAAU,MAAM,KAAK,aAAa,MAAM;AAG9C,aAAK,WAAW,OAA6B,EAAE,MAAM,MAAM;AAAA,QAAC,CAAC;AAE7D,eAAO,IAAI,2BAAa,SAAS;AAAA,UAC/B,QAAQ;AAAA,UACR,SAAS;AAAA,YACP,gBAAgB;AAAA,YAChB,iBAAiB,mBAAmB,MAAM;AAAA,UAC5C;AAAA,QACF,CAAC;AAAA,MACH,QAAQ;AACN,eAAO,IAAI,2BAAa,yBAAyB;AAAA,UAC/C,QAAQ;AAAA,UACR,SAAS,EAAE,gBAAgB,4BAA4B;AAAA,QACzD,CAAC;AAAA,MACH;AAAA,IACF;AAGA,UAAM,WAAW,2BAAa,KAAK;AAEnC,QAAI,YAAY;AACd,eAAS,QAAQ,IAAI,QAAQ,KAAK,mBAAmB,CAAC;AAAA,IACxD;AAEA,WAAO;AAAA,EACT;AACF;;;ACjEA,IAAAA,sBAA4B;AAqBrB,SAAS,kBAAkB,QAEhC;AACA,QAAM,WAAsB,iCAAY,MAAM;AAC9C,QAAM,SAAS,OAAO,eAAe;AAErC,SAAO;AAAA,IACL,MAAM,IAAI,SAAqC;AAC7C,YAAM,MAAM,IAAI,IAAI,QAAQ,GAAG;AAC/B,YAAM,SACJ,IAAI,SAAS,SAAS,gBAAgB,KACtC,IAAI,aAAa,IAAI,MAAM,MAAM;AAEnC,UAAI;AACF,cAAM,UAAU,MAAM,KAAK,aAAa,MAAM;AAG9C,aAAK,WAAW,OAAO,EAAE,MAAM,MAAM;AAAA,QAAC,CAAC;AAEvC,eAAO,IAAI,SAAS,SAAS;AAAA,UAC3B,QAAQ;AAAA,UACR,SAAS;AAAA,YACP,gBAAgB;AAAA,YAChB,iBAAiB,mBAAmB,MAAM;AAAA,UAC5C;AAAA,QACF,CAAC;AAAA,MACH,QAAQ;AACN,eAAO,IAAI,SAAS,yBAAyB;AAAA,UAC3C,QAAQ;AAAA,UACR,SAAS,EAAE,gBAAgB,4BAA4B;AAAA,QACzD,CAAC;AAAA,MACH;AAAA,IACF;AAAA,EACF;AACF;;;AF5CA,IAAAC,sBAWO;","names":["import_geo_ai_core","import_geo_ai_core"]}
+{"version":3,"sources":["../src/index.ts","../src/middleware.ts","../src/handler.ts","../src/generate.ts"],"sourcesContent":["// geo-ai-next main entry point\n\n// Next.js middleware\nexport { geoAIMiddleware } from './middleware';\nexport type { GeoAIMiddlewareConfig } from './middleware';\n\n// Next.js route handler\nexport { createLlmsHandler } from './handler';\nexport type { LlmsHandlerConfig } from './handler';\n\n// Static file generation (build step)\nexport { generateLlmsFiles } from './generate';\nexport type { GenerateLlmsFilesConfig, GenerateLlmsFilesResult } from './generate';\n\n// Re-export all public types, interfaces, and classes from geo-ai-core\nexport {\n  createGeoAI,\n  MemoryCacheAdapter,\n  FileCacheAdapter,\n  CrawlTracker,\n  MemoryCrawlStore,\n  CryptoService,\n  BotRulesEngine,\n  AI_BOTS,\n  SeoGenerator,\n  LlmsGenerator,\n} from 'geo-ai-core';\n\nexport type {\n  GeoAIInstance,\n  Resource,\n  ProductResource,\n  ResourceSection,\n  ContentProvider,\n  CacheAdapter,\n  CrawlEntry,\n  CrawlActivity,\n  CrawlStore,\n  CrawlTrackingConfig,\n  CryptoConfig,\n  GeoAIConfig,\n  AiProvider,\n  AiGeneratorConfig,\n  AiError,\n  AiBulkConfig,\n  AiContext,\n} from 'geo-ai-core';\n","import { NextResponse } from 'next/server';\nimport type { NextRequest } from 'next/server';\nimport { createGeoAI } from 'geo-ai-core';\nimport type { GeoAIConfig, GeoAIInstance } from 'geo-ai-core';\n\n// ── Config ──────────────────────────────────────────────────────────\n\nexport interface GeoAIMiddlewareConfig extends GeoAIConfig {\n  /** Inject Link header pointing to llms.txt on non-llms responses. Default: false */\n  injectLinkHeader?: boolean;\n  /** Cache-Control max-age in seconds for llms.txt responses. Default: 3600 */\n  cacheMaxAge?: number;\n}\n\n// ── Middleware factory ───────────────────────────────────────────────\n\n/**\n * Creates a Next.js middleware function that intercepts `/llms.txt` and\n * `/llms-full.txt` requests, returning generated content as `text/plain`.\n * All other paths are passed through via `NextResponse.next()`.\n */\nexport function geoAIMiddleware(\n  config: GeoAIMiddlewareConfig,\n): (request: NextRequest) => Promise<NextResponse> {\n  const core: GeoAIInstance = createGeoAI(config);\n  const injectLink = config.injectLinkHeader ?? false;\n  const maxAge = config.cacheMaxAge ?? 3600;\n\n  return async (request: NextRequest): Promise<NextResponse> => {\n    const { pathname } = request.nextUrl;\n\n    // ── Match llms paths ───────────────────────────────────────────\n    if (pathname === '/llms.txt' || pathname === '/llms-full.txt') {\n      const isFull = pathname === '/llms-full.txt';\n\n      try {\n        const content = await core.generateLlms(isFull);\n\n        // Fire-and-forget: track visit without blocking the response\n        core.trackVisit(request as unknown as Request).catch(() => {});\n\n        return new NextResponse(content, {\n          status: 200,\n          headers: {\n            'Content-Type': 'text/plain; charset=utf-8',\n            'Cache-Control': `public, max-age=${maxAge}`,\n          },\n        });\n      } catch {\n        return new NextResponse('Internal Server Error', {\n          status: 500,\n          headers: { 'Content-Type': 'text/plain; charset=utf-8' },\n        });\n      }\n    }\n\n    // ── Passthrough ────────────────────────────────────────────────\n    const response = NextResponse.next();\n\n    if (injectLink) {\n      response.headers.set('Link', core.generateLinkHeader());\n    }\n\n    return response;\n  };\n}\n","import { createGeoAI } from 'geo-ai-core';\nimport type { GeoAIConfig, GeoAIInstance } from 'geo-ai-core';\n\n// ── Config ──────────────────────────────────────────────────────────\n\nexport interface LlmsHandlerConfig extends GeoAIConfig {\n  /** Cache-Control max-age in seconds for llms.txt responses. Default: 3600 */\n  cacheMaxAge?: number;\n}\n\n// ── Route Handler factory ───────────────────────────────────────────\n\n/**\n * Creates a Next.js App Router route handler that serves llms.txt content.\n * File type is determined by URL path (`/llms-full.txt`) or query `?type=full`.\n *\n * Usage in `app/llms/route.ts`:\n * ```ts\n * export const { GET } = createLlmsHandler({ ... });\n * ```\n */\nexport function createLlmsHandler(config: LlmsHandlerConfig): {\n  GET: (request: Request) => Promise<Response>;\n} {\n  const core: GeoAIInstance = createGeoAI(config);\n  const maxAge = config.cacheMaxAge ?? 3600;\n\n  return {\n    async GET(request: Request): Promise<Response> {\n      const url = new URL(request.url);\n      const isFull =\n        url.pathname.endsWith('/llms-full.txt') ||\n        url.searchParams.get('type') === 'full';\n\n      try {\n        const content = await core.generateLlms(isFull);\n\n        // Fire-and-forget: log bot visit without blocking the response\n        core.trackVisit(request).catch(() => {});\n\n        return new Response(content, {\n          status: 200,\n          headers: {\n            'Content-Type': 'text/plain; charset=utf-8',\n            'Cache-Control': `public, max-age=${maxAge}`,\n          },\n        });\n      } catch {\n        return new Response('Internal Server Error', {\n          status: 500,\n          headers: { 'Content-Type': 'text/plain; charset=utf-8' },\n        });\n      }\n    },\n  };\n}\n","import { createGeoAI } from 'geo-ai-core';\nimport type { GeoAIConfig } from 'geo-ai-core';\nimport { writeFile, mkdir } from 'node:fs/promises';\nimport { join, resolve } from 'node:path';\n\n// ── Config ──────────────────────────────────────────────────────────\n\nexport interface GenerateLlmsFilesConfig extends GeoAIConfig {\n  /** Output directory for generated files. Default: 'public' (relative to cwd) */\n  outDir?: string;\n  /** Locale for content generation */\n  locale?: string;\n}\n\nexport interface GenerateLlmsFilesResult {\n  llmsPath: string;\n  llmsFullPath: string;\n}\n\n// ── Generator ───────────────────────────────────────────────────────\n\n/**\n * Generates `llms.txt` and `llms-full.txt` as static files in the output\n * directory (default: `public/`). Designed to be called from a build script\n * or `next.config.js` before `next build`.\n *\n * - Creates the output directory if it doesn't exist\n * - Overwrites existing files atomically (write to temp, then rename)\n * - Logs progress to stdout\n * - Throws on failure with a descriptive error\n *\n * @example\n * ```ts\n * // scripts/generate-llms.ts\n * import { generateLlmsFiles } from 'geo-ai-next';\n *\n * await generateLlmsFiles({\n *   siteName: 'My Site',\n *   siteUrl: 'https://example.com',\n *   provider: { Pages: [{ title: 'Home', url: '/' }] },\n * });\n * ```\n */\nexport async function generateLlmsFiles(\n  config: GenerateLlmsFilesConfig,\n): Promise<GenerateLlmsFilesResult> {\n  const outDir = resolve(config.outDir ?? 'public');\n\n  console.log(`[geo-ai] Generating llms files → ${outDir}`);\n\n  const core = createGeoAI(config);\n\n  // Ensure output directory exists\n  await mkdir(outDir, { recursive: true });\n\n  // Generate both variants\n  const [llmsContent, llmsFullContent] = await Promise.all([\n    core.generateLlms(false, config.locale),\n    core.generateLlms(true, config.locale),\n  ]);\n\n  const llmsPath = join(outDir, 'llms.txt');\n  const llmsFullPath = join(outDir, 'llms-full.txt');\n\n  // Write files atomically: write temp then rename\n  const tmpLlms = `${llmsPath}.tmp`;\n  const tmpFull = `${llmsFullPath}.tmp`;\n\n  try {\n    await Promise.all([\n      writeFile(tmpLlms, llmsContent, 'utf-8'),\n      writeFile(tmpFull, llmsFullContent, 'utf-8'),\n    ]);\n\n    // Rename is atomic on most filesystems\n    const { rename } = await import('node:fs/promises');\n    await Promise.all([\n      rename(tmpLlms, llmsPath),\n      rename(tmpFull, llmsFullPath),\n    ]);\n  } catch (err) {\n    // Clean up temp files on failure\n    const { unlink } = await import('node:fs/promises');\n    await unlink(tmpLlms).catch(() => {});\n    await unlink(tmpFull).catch(() => {});\n    throw err;\n  }\n\n  console.log(`[geo-ai] ✓ ${llmsPath} (${llmsContent.length} bytes)`);\n  console.log(`[geo-ai] ✓ ${llmsFullPath} (${llmsFullContent.length} bytes)`);\n\n  return { llmsPath, llmsFullPath };\n}\n"],"mappings":"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","names":["import_geo_ai_core","import_geo_ai_core","import_geo_ai_core"]}

package/dist/index.d.cts

@@ -32,4 +32,38 @@ declare function createLlmsHandler(config: LlmsHandlerConfig): {
     GET: (request: Request) => Promise<Response>;
 };
 
-export { type GeoAIMiddlewareConfig, type LlmsHandlerConfig, createLlmsHandler, geoAIMiddleware };
+interface GenerateLlmsFilesConfig extends GeoAIConfig {
+    /** Output directory for generated files. Default: 'public' (relative to cwd) */
+    outDir?: string;
+    /** Locale for content generation */
+    locale?: string;
+}
+interface GenerateLlmsFilesResult {
+    llmsPath: string;
+    llmsFullPath: string;
+}
+/**
+ * Generates `llms.txt` and `llms-full.txt` as static files in the output
+ * directory (default: `public/`). Designed to be called from a build script
+ * or `next.config.js` before `next build`.
+ *
+ * - Creates the output directory if it doesn't exist
+ * - Overwrites existing files atomically (write to temp, then rename)
+ * - Logs progress to stdout
+ * - Throws on failure with a descriptive error
+ *
+ * @example
+ * ```ts
+ * // scripts/generate-llms.ts
+ * import { generateLlmsFiles } from 'geo-ai-next';
+ *
+ * await generateLlmsFiles({
+ *   siteName: 'My Site',
+ *   siteUrl: 'https://example.com',
+ *   provider: { Pages: [{ title: 'Home', url: '/' }] },
+ * });
+ * ```
+ */
+declare function generateLlmsFiles(config: GenerateLlmsFilesConfig): Promise<GenerateLlmsFilesResult>;
+
+export { type GenerateLlmsFilesConfig, type GenerateLlmsFilesResult, type GeoAIMiddlewareConfig, type LlmsHandlerConfig, createLlmsHandler, generateLlmsFiles, geoAIMiddleware };

package/dist/index.d.ts

@@ -32,4 +32,38 @@ declare function createLlmsHandler(config: LlmsHandlerConfig): {
     GET: (request: Request) => Promise<Response>;
 };
 
-export { type GeoAIMiddlewareConfig, type LlmsHandlerConfig, createLlmsHandler, geoAIMiddleware };
+interface GenerateLlmsFilesConfig extends GeoAIConfig {
+    /** Output directory for generated files. Default: 'public' (relative to cwd) */
+    outDir?: string;
+    /** Locale for content generation */
+    locale?: string;
+}
+interface GenerateLlmsFilesResult {
+    llmsPath: string;
+    llmsFullPath: string;
+}
+/**
+ * Generates `llms.txt` and `llms-full.txt` as static files in the output
+ * directory (default: `public/`). Designed to be called from a build script
+ * or `next.config.js` before `next build`.
+ *
+ * - Creates the output directory if it doesn't exist
+ * - Overwrites existing files atomically (write to temp, then rename)
+ * - Logs progress to stdout
+ * - Throws on failure with a descriptive error
+ *
+ * @example
+ * ```ts
+ * // scripts/generate-llms.ts
+ * import { generateLlmsFiles } from 'geo-ai-next';
+ *
+ * await generateLlmsFiles({
+ *   siteName: 'My Site',
+ *   siteUrl: 'https://example.com',
+ *   provider: { Pages: [{ title: 'Home', url: '/' }] },
+ * });
+ * ```
+ */
+declare function generateLlmsFiles(config: GenerateLlmsFilesConfig): Promise<GenerateLlmsFilesResult>;
+
+export { type GenerateLlmsFilesConfig, type GenerateLlmsFilesResult, type GeoAIMiddlewareConfig, type LlmsHandlerConfig, createLlmsHandler, generateLlmsFiles, geoAIMiddleware };

package/dist/index.mjs

@@ -65,9 +65,49 @@ function createLlmsHandler(config) {
   };
 }
 
+// src/generate.ts
+import { createGeoAI as createGeoAI3 } from "geo-ai-core";
+import { writeFile, mkdir } from "fs/promises";
+import { join, resolve } from "path";
+async function generateLlmsFiles(config) {
+  const outDir = resolve(config.outDir ?? "public");
+  console.log(`[geo-ai] Generating llms files \u2192 ${outDir}`);
+  const core = createGeoAI3(config);
+  await mkdir(outDir, { recursive: true });
+  const [llmsContent, llmsFullContent] = await Promise.all([
+    core.generateLlms(false, config.locale),
+    core.generateLlms(true, config.locale)
+  ]);
+  const llmsPath = join(outDir, "llms.txt");
+  const llmsFullPath = join(outDir, "llms-full.txt");
+  const tmpLlms = `${llmsPath}.tmp`;
+  const tmpFull = `${llmsFullPath}.tmp`;
+  try {
+    await Promise.all([
+      writeFile(tmpLlms, llmsContent, "utf-8"),
+      writeFile(tmpFull, llmsFullContent, "utf-8")
+    ]);
+    const { rename } = await import("fs/promises");
+    await Promise.all([
+      rename(tmpLlms, llmsPath),
+      rename(tmpFull, llmsFullPath)
+    ]);
+  } catch (err) {
+    const { unlink } = await import("fs/promises");
+    await unlink(tmpLlms).catch(() => {
+    });
+    await unlink(tmpFull).catch(() => {
+    });
+    throw err;
+  }
+  console.log(`[geo-ai] \u2713 ${llmsPath} (${llmsContent.length} bytes)`);
+  console.log(`[geo-ai] \u2713 ${llmsFullPath} (${llmsFullContent.length} bytes)`);
+  return { llmsPath, llmsFullPath };
+}
+
 // src/index.ts
 import {
-  createGeoAI as createGeoAI3,
+  createGeoAI as createGeoAI4,
   MemoryCacheAdapter,
   FileCacheAdapter,
   CrawlTracker,
@@ -88,8 +128,9 @@ export {
   MemoryCacheAdapter,
   MemoryCrawlStore,
   SeoGenerator,
-  createGeoAI3 as createGeoAI,
+  createGeoAI4 as createGeoAI,
   createLlmsHandler,
+  generateLlmsFiles,
   geoAIMiddleware
 };
 //# sourceMappingURL=index.mjs.map

package/dist/index.mjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/middleware.ts","../src/handler.ts","../src/index.ts"],"sourcesContent":["import { NextResponse } from 'next/server';\nimport type { NextRequest } from 'next/server';\nimport { createGeoAI } from 'geo-ai-core';\nimport type { GeoAIConfig, GeoAIInstance } from 'geo-ai-core';\n\n// ── Config ──────────────────────────────────────────────────────────\n\nexport interface GeoAIMiddlewareConfig extends GeoAIConfig {\n  /** Inject Link header pointing to llms.txt on non-llms responses. Default: false */\n  injectLinkHeader?: boolean;\n  /** Cache-Control max-age in seconds for llms.txt responses. Default: 3600 */\n  cacheMaxAge?: number;\n}\n\n// ── Middleware factory ───────────────────────────────────────────────\n\n/**\n * Creates a Next.js middleware function that intercepts `/llms.txt` and\n * `/llms-full.txt` requests, returning generated content as `text/plain`.\n * All other paths are passed through via `NextResponse.next()`.\n */\nexport function geoAIMiddleware(\n  config: GeoAIMiddlewareConfig,\n): (request: NextRequest) => Promise<NextResponse> {\n  const core: GeoAIInstance = createGeoAI(config);\n  const injectLink = config.injectLinkHeader ?? false;\n  const maxAge = config.cacheMaxAge ?? 3600;\n\n  return async (request: NextRequest): Promise<NextResponse> => {\n    const { pathname } = request.nextUrl;\n\n    // ── Match llms paths ───────────────────────────────────────────\n    if (pathname === '/llms.txt' || pathname === '/llms-full.txt') {\n      const isFull = pathname === '/llms-full.txt';\n\n      try {\n        const content = await core.generateLlms(isFull);\n\n        // Fire-and-forget: track visit without blocking the response\n        core.trackVisit(request as unknown as Request).catch(() => {});\n\n        return new NextResponse(content, {\n          status: 200,\n          headers: {\n            'Content-Type': 'text/plain; charset=utf-8',\n            'Cache-Control': `public, max-age=${maxAge}`,\n          },\n        });\n      } catch {\n        return new NextResponse('Internal Server Error', {\n          status: 500,\n          headers: { 'Content-Type': 'text/plain; charset=utf-8' },\n        });\n      }\n    }\n\n    // ── Passthrough ────────────────────────────────────────────────\n    const response = NextResponse.next();\n\n    if (injectLink) {\n      response.headers.set('Link', core.generateLinkHeader());\n    }\n\n    return response;\n  };\n}\n","import { createGeoAI } from 'geo-ai-core';\nimport type { GeoAIConfig, GeoAIInstance } from 'geo-ai-core';\n\n// ── Config ──────────────────────────────────────────────────────────\n\nexport interface LlmsHandlerConfig extends GeoAIConfig {\n  /** Cache-Control max-age in seconds for llms.txt responses. Default: 3600 */\n  cacheMaxAge?: number;\n}\n\n// ── Route Handler factory ───────────────────────────────────────────\n\n/**\n * Creates a Next.js App Router route handler that serves llms.txt content.\n * File type is determined by URL path (`/llms-full.txt`) or query `?type=full`.\n *\n * Usage in `app/llms/route.ts`:\n * ```ts\n * export const { GET } = createLlmsHandler({ ... });\n * ```\n */\nexport function createLlmsHandler(config: LlmsHandlerConfig): {\n  GET: (request: Request) => Promise<Response>;\n} {\n  const core: GeoAIInstance = createGeoAI(config);\n  const maxAge = config.cacheMaxAge ?? 3600;\n\n  return {\n    async GET(request: Request): Promise<Response> {\n      const url = new URL(request.url);\n      const isFull =\n        url.pathname.endsWith('/llms-full.txt') ||\n        url.searchParams.get('type') === 'full';\n\n      try {\n        const content = await core.generateLlms(isFull);\n\n        // Fire-and-forget: log bot visit without blocking the response\n        core.trackVisit(request).catch(() => {});\n\n        return new Response(content, {\n          status: 200,\n          headers: {\n            'Content-Type': 'text/plain; charset=utf-8',\n            'Cache-Control': `public, max-age=${maxAge}`,\n          },\n        });\n      } catch {\n        return new Response('Internal Server Error', {\n          status: 500,\n          headers: { 'Content-Type': 'text/plain; charset=utf-8' },\n        });\n      }\n    },\n  };\n}\n","// geo-ai-next main entry point\n\n// Next.js middleware\nexport { geoAIMiddleware } from './middleware';\nexport type { GeoAIMiddlewareConfig } from './middleware';\n\n// Next.js route handler\nexport { createLlmsHandler } from './handler';\nexport type { LlmsHandlerConfig } from './handler';\n\n// Re-export all public types, interfaces, and classes from geo-ai-core\nexport {\n  createGeoAI,\n  MemoryCacheAdapter,\n  FileCacheAdapter,\n  CrawlTracker,\n  MemoryCrawlStore,\n  CryptoService,\n  BotRulesEngine,\n  AI_BOTS,\n  SeoGenerator,\n  LlmsGenerator,\n} from 'geo-ai-core';\n\nexport type {\n  GeoAIInstance,\n  Resource,\n  ProductResource,\n  ResourceSection,\n  ContentProvider,\n  CacheAdapter,\n  CrawlEntry,\n  CrawlActivity,\n  CrawlStore,\n  CrawlTrackingConfig,\n  CryptoConfig,\n  GeoAIConfig,\n  AiProvider,\n  AiGeneratorConfig,\n  AiError,\n  AiBulkConfig,\n  AiContext,\n} from 'geo-ai-core';\n"],"mappings":";AAAA,SAAS,oBAAoB;AAE7B,SAAS,mBAAmB;AAmBrB,SAAS,gBACd,QACiD;AACjD,QAAM,OAAsB,YAAY,MAAM;AAC9C,QAAM,aAAa,OAAO,oBAAoB;AAC9C,QAAM,SAAS,OAAO,eAAe;AAErC,SAAO,OAAO,YAAgD;AAC5D,UAAM,EAAE,SAAS,IAAI,QAAQ;AAG7B,QAAI,aAAa,eAAe,aAAa,kBAAkB;AAC7D,YAAM,SAAS,aAAa;AAE5B,UAAI;AACF,cAAM,UAAU,MAAM,KAAK,aAAa,MAAM;AAG9C,aAAK,WAAW,OAA6B,EAAE,MAAM,MAAM;AAAA,QAAC,CAAC;AAE7D,eAAO,IAAI,aAAa,SAAS;AAAA,UAC/B,QAAQ;AAAA,UACR,SAAS;AAAA,YACP,gBAAgB;AAAA,YAChB,iBAAiB,mBAAmB,MAAM;AAAA,UAC5C;AAAA,QACF,CAAC;AAAA,MACH,QAAQ;AACN,eAAO,IAAI,aAAa,yBAAyB;AAAA,UAC/C,QAAQ;AAAA,UACR,SAAS,EAAE,gBAAgB,4BAA4B;AAAA,QACzD,CAAC;AAAA,MACH;AAAA,IACF;AAGA,UAAM,WAAW,aAAa,KAAK;AAEnC,QAAI,YAAY;AACd,eAAS,QAAQ,IAAI,QAAQ,KAAK,mBAAmB,CAAC;AAAA,IACxD;AAEA,WAAO;AAAA,EACT;AACF;;;ACjEA,SAAS,eAAAA,oBAAmB;AAqBrB,SAAS,kBAAkB,QAEhC;AACA,QAAM,OAAsBA,aAAY,MAAM;AAC9C,QAAM,SAAS,OAAO,eAAe;AAErC,SAAO;AAAA,IACL,MAAM,IAAI,SAAqC;AAC7C,YAAM,MAAM,IAAI,IAAI,QAAQ,GAAG;AAC/B,YAAM,SACJ,IAAI,SAAS,SAAS,gBAAgB,KACtC,IAAI,aAAa,IAAI,MAAM,MAAM;AAEnC,UAAI;AACF,cAAM,UAAU,MAAM,KAAK,aAAa,MAAM;AAG9C,aAAK,WAAW,OAAO,EAAE,MAAM,MAAM;AAAA,QAAC,CAAC;AAEvC,eAAO,IAAI,SAAS,SAAS;AAAA,UAC3B,QAAQ;AAAA,UACR,SAAS;AAAA,YACP,gBAAgB;AAAA,YAChB,iBAAiB,mBAAmB,MAAM;AAAA,UAC5C;AAAA,QACF,CAAC;AAAA,MACH,QAAQ;AACN,eAAO,IAAI,SAAS,yBAAyB;AAAA,UAC3C,QAAQ;AAAA,UACR,SAAS,EAAE,gBAAgB,4BAA4B;AAAA,QACzD,CAAC;AAAA,MACH;AAAA,IACF;AAAA,EACF;AACF;;;AC5CA;AAAA,EACE,eAAAC;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OACK;","names":["createGeoAI","createGeoAI"]}
+{"version":3,"sources":["../src/middleware.ts","../src/handler.ts","../src/generate.ts","../src/index.ts"],"sourcesContent":["import { NextResponse } from 'next/server';\nimport type { NextRequest } from 'next/server';\nimport { createGeoAI } from 'geo-ai-core';\nimport type { GeoAIConfig, GeoAIInstance } from 'geo-ai-core';\n\n// ── Config ──────────────────────────────────────────────────────────\n\nexport interface GeoAIMiddlewareConfig extends GeoAIConfig {\n  /** Inject Link header pointing to llms.txt on non-llms responses. Default: false */\n  injectLinkHeader?: boolean;\n  /** Cache-Control max-age in seconds for llms.txt responses. Default: 3600 */\n  cacheMaxAge?: number;\n}\n\n// ── Middleware factory ───────────────────────────────────────────────\n\n/**\n * Creates a Next.js middleware function that intercepts `/llms.txt` and\n * `/llms-full.txt` requests, returning generated content as `text/plain`.\n * All other paths are passed through via `NextResponse.next()`.\n */\nexport function geoAIMiddleware(\n  config: GeoAIMiddlewareConfig,\n): (request: NextRequest) => Promise<NextResponse> {\n  const core: GeoAIInstance = createGeoAI(config);\n  const injectLink = config.injectLinkHeader ?? false;\n  const maxAge = config.cacheMaxAge ?? 3600;\n\n  return async (request: NextRequest): Promise<NextResponse> => {\n    const { pathname } = request.nextUrl;\n\n    // ── Match llms paths ───────────────────────────────────────────\n    if (pathname === '/llms.txt' || pathname === '/llms-full.txt') {\n      const isFull = pathname === '/llms-full.txt';\n\n      try {\n        const content = await core.generateLlms(isFull);\n\n        // Fire-and-forget: track visit without blocking the response\n        core.trackVisit(request as unknown as Request).catch(() => {});\n\n        return new NextResponse(content, {\n          status: 200,\n          headers: {\n            'Content-Type': 'text/plain; charset=utf-8',\n            'Cache-Control': `public, max-age=${maxAge}`,\n          },\n        });\n      } catch {\n        return new NextResponse('Internal Server Error', {\n          status: 500,\n          headers: { 'Content-Type': 'text/plain; charset=utf-8' },\n        });\n      }\n    }\n\n    // ── Passthrough ────────────────────────────────────────────────\n    const response = NextResponse.next();\n\n    if (injectLink) {\n      response.headers.set('Link', core.generateLinkHeader());\n    }\n\n    return response;\n  };\n}\n","import { createGeoAI } from 'geo-ai-core';\nimport type { GeoAIConfig, GeoAIInstance } from 'geo-ai-core';\n\n// ── Config ──────────────────────────────────────────────────────────\n\nexport interface LlmsHandlerConfig extends GeoAIConfig {\n  /** Cache-Control max-age in seconds for llms.txt responses. Default: 3600 */\n  cacheMaxAge?: number;\n}\n\n// ── Route Handler factory ───────────────────────────────────────────\n\n/**\n * Creates a Next.js App Router route handler that serves llms.txt content.\n * File type is determined by URL path (`/llms-full.txt`) or query `?type=full`.\n *\n * Usage in `app/llms/route.ts`:\n * ```ts\n * export const { GET } = createLlmsHandler({ ... });\n * ```\n */\nexport function createLlmsHandler(config: LlmsHandlerConfig): {\n  GET: (request: Request) => Promise<Response>;\n} {\n  const core: GeoAIInstance = createGeoAI(config);\n  const maxAge = config.cacheMaxAge ?? 3600;\n\n  return {\n    async GET(request: Request): Promise<Response> {\n      const url = new URL(request.url);\n      const isFull =\n        url.pathname.endsWith('/llms-full.txt') ||\n        url.searchParams.get('type') === 'full';\n\n      try {\n        const content = await core.generateLlms(isFull);\n\n        // Fire-and-forget: log bot visit without blocking the response\n        core.trackVisit(request).catch(() => {});\n\n        return new Response(content, {\n          status: 200,\n          headers: {\n            'Content-Type': 'text/plain; charset=utf-8',\n            'Cache-Control': `public, max-age=${maxAge}`,\n          },\n        });\n      } catch {\n        return new Response('Internal Server Error', {\n          status: 500,\n          headers: { 'Content-Type': 'text/plain; charset=utf-8' },\n        });\n      }\n    },\n  };\n}\n","import { createGeoAI } from 'geo-ai-core';\nimport type { GeoAIConfig } from 'geo-ai-core';\nimport { writeFile, mkdir } from 'node:fs/promises';\nimport { join, resolve } from 'node:path';\n\n// ── Config ──────────────────────────────────────────────────────────\n\nexport interface GenerateLlmsFilesConfig extends GeoAIConfig {\n  /** Output directory for generated files. Default: 'public' (relative to cwd) */\n  outDir?: string;\n  /** Locale for content generation */\n  locale?: string;\n}\n\nexport interface GenerateLlmsFilesResult {\n  llmsPath: string;\n  llmsFullPath: string;\n}\n\n// ── Generator ───────────────────────────────────────────────────────\n\n/**\n * Generates `llms.txt` and `llms-full.txt` as static files in the output\n * directory (default: `public/`). Designed to be called from a build script\n * or `next.config.js` before `next build`.\n *\n * - Creates the output directory if it doesn't exist\n * - Overwrites existing files atomically (write to temp, then rename)\n * - Logs progress to stdout\n * - Throws on failure with a descriptive error\n *\n * @example\n * ```ts\n * // scripts/generate-llms.ts\n * import { generateLlmsFiles } from 'geo-ai-next';\n *\n * await generateLlmsFiles({\n *   siteName: 'My Site',\n *   siteUrl: 'https://example.com',\n *   provider: { Pages: [{ title: 'Home', url: '/' }] },\n * });\n * ```\n */\nexport async function generateLlmsFiles(\n  config: GenerateLlmsFilesConfig,\n): Promise<GenerateLlmsFilesResult> {\n  const outDir = resolve(config.outDir ?? 'public');\n\n  console.log(`[geo-ai] Generating llms files → ${outDir}`);\n\n  const core = createGeoAI(config);\n\n  // Ensure output directory exists\n  await mkdir(outDir, { recursive: true });\n\n  // Generate both variants\n  const [llmsContent, llmsFullContent] = await Promise.all([\n    core.generateLlms(false, config.locale),\n    core.generateLlms(true, config.locale),\n  ]);\n\n  const llmsPath = join(outDir, 'llms.txt');\n  const llmsFullPath = join(outDir, 'llms-full.txt');\n\n  // Write files atomically: write temp then rename\n  const tmpLlms = `${llmsPath}.tmp`;\n  const tmpFull = `${llmsFullPath}.tmp`;\n\n  try {\n    await Promise.all([\n      writeFile(tmpLlms, llmsContent, 'utf-8'),\n      writeFile(tmpFull, llmsFullContent, 'utf-8'),\n    ]);\n\n    // Rename is atomic on most filesystems\n    const { rename } = await import('node:fs/promises');\n    await Promise.all([\n      rename(tmpLlms, llmsPath),\n      rename(tmpFull, llmsFullPath),\n    ]);\n  } catch (err) {\n    // Clean up temp files on failure\n    const { unlink } = await import('node:fs/promises');\n    await unlink(tmpLlms).catch(() => {});\n    await unlink(tmpFull).catch(() => {});\n    throw err;\n  }\n\n  console.log(`[geo-ai] ✓ ${llmsPath} (${llmsContent.length} bytes)`);\n  console.log(`[geo-ai] ✓ ${llmsFullPath} (${llmsFullContent.length} bytes)`);\n\n  return { llmsPath, llmsFullPath };\n}\n","// geo-ai-next main entry point\n\n// Next.js middleware\nexport { geoAIMiddleware } from './middleware';\nexport type { GeoAIMiddlewareConfig } from './middleware';\n\n// Next.js route handler\nexport { createLlmsHandler } from './handler';\nexport type { LlmsHandlerConfig } from './handler';\n\n// Static file generation (build step)\nexport { generateLlmsFiles } from './generate';\nexport type { GenerateLlmsFilesConfig, GenerateLlmsFilesResult } from './generate';\n\n// Re-export all public types, interfaces, and classes from geo-ai-core\nexport {\n  createGeoAI,\n  MemoryCacheAdapter,\n  FileCacheAdapter,\n  CrawlTracker,\n  MemoryCrawlStore,\n  CryptoService,\n  BotRulesEngine,\n  AI_BOTS,\n  SeoGenerator,\n  LlmsGenerator,\n} from 'geo-ai-core';\n\nexport type {\n  GeoAIInstance,\n  Resource,\n  ProductResource,\n  ResourceSection,\n  ContentProvider,\n  CacheAdapter,\n  CrawlEntry,\n  CrawlActivity,\n  CrawlStore,\n  CrawlTrackingConfig,\n  CryptoConfig,\n  GeoAIConfig,\n  AiProvider,\n  AiGeneratorConfig,\n  AiError,\n  AiBulkConfig,\n  AiContext,\n} from 'geo-ai-core';\n"],"mappings":"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","names":["createGeoAI","createGeoAI","createGeoAI"]}

package/package.json

@@ -1,7 +1,13 @@
 {
   "name": "geo-ai-next",
-  "version": "0.1.1",
+  "version": "0.2.0",
   "license": "GPL-2.0",
+  "homepage": "https://www.geoai.run",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/madeburo/GEO-AI.git",
+    "directory": "packages/next"
+  },
   "type": "module",
   "exports": {
     ".": {
@@ -19,7 +25,8 @@
     "llms-txt",
     "llms.txt",
     "ai",
-    "generative-engine-optimization",
+    "ai-search-optimization",
+    "geoai",
     "nextjs",
     "next",
     "middleware",
@@ -38,12 +45,15 @@
   "files": [
     "dist"
   ],
+  "bin": {
+    "geo-ai-generate": "dist/cli.mjs"
+  },
   "scripts": {
     "build": "tsup",
     "typecheck": "tsc --noEmit"
   },
   "dependencies": {
-    "geo-ai-core": "*"
+    "geo-ai-core": "^0.2.0"
   },
   "engines": {
     "node": ">=20"