@yak-io/nextjs 0.1.3 → 0.1.5

package/README.md

@@ -164,29 +164,27 @@ Behind the scenes `@yak-io/javascript` merges every `RouteSource` into a single
 yak-nextjs generate-manifest
 ```
 
-Use the CLI to pre-compute a manifest at build time. The JSON matches the runtime manifest structure exposed by the handlers.
+Use the CLI to generate a TypeScript module with your routes at build time.
 
 **Options:**
 - `--app-dir <path>` – Path to Next.js app directory (default: `./src/app`)
 - `--pages-dir <path>` – Path to Next.js pages directory (optional, scanned in addition to app-dir)
-- `--output <path>` – Output file path (default: `./public/yak-routes-manifest.json`)
+- `--output <path>` – Output file path (default: `./src/yak.routes.ts`)
 
 **Examples:**
 ```bash
 yak-nextjs generate-manifest
 yak-nextjs generate-manifest --pages-dir ./src/pages
-yak-nextjs generate-manifest --app-dir ./app --pages-dir ./pages
+yak-nextjs generate-manifest --app-dir ./app --output ./src/generated/routes.ts
 ```
 
 ## Route Manifest for Production
 
 During local development, routes are scanned directly from the filesystem—no setup needed. However, when you build your Next.js app for production, only the compiled `.next` output is included. Source files like `./src/app` are not present at runtime.
 
-To enable route scanning in production builds, generate a manifest at build time.
-
 ### Recommended setup
 
-Add a `prebuild` script to generate the manifest before Next.js builds:
+1. Add a `prebuild` script to generate the manifest before Next.js builds:
 
 ```json
 {
@@ -197,9 +195,35 @@ Add a `prebuild` script to generate the manifest before Next.js builds:
 }
 ```
 
-That's it! The manifest is generated to `./public/yak-routes-manifest.json` and the handler automatically fetches it at runtime on serverless platforms like Vercel. No code changes needed.
+2. Use the route manifest adapter in your handler:
+
+```ts
+// app/api/yak/[...yak]/route.ts
+import { createNextYakHandler, createRouteManifestAdapter } from "@yak-io/nextjs/server";
+import { routes } from "@/yak.routes";
+
+export const { GET, POST } = createNextYakHandler({
+  routes: createRouteManifestAdapter({ routes }),
+});
+```
+
+The generated TypeScript module is imported directly, ensuring it's bundled with your serverless function automatically.
+
+### Route filtering
+
+Use `allowedRoutes` and `disallowedRoutes` to control which routes are exposed (similar to tRPC adapter):
+
+```ts
+createRouteManifestAdapter({
+  routes,
+  allowedRoutes: ["/docs/*", "/pricing", "/"],
+  disallowedRoutes: ["/docs/internal/*"],
+})
+```
 
-The handler automatically detects the deployment environment (Vercel via `VERCEL_URL`, Netlify via `URL`, or custom `NEXT_PUBLIC_BASE_URL`) and fetches the manifest from the public folder.
+Pattern matching:
+- Exact match: `"/pricing"` matches only `/pricing`
+- Prefix match: `"/docs/*"` matches `/docs`, `/docs/getting-started`, etc.
 
 ### Alternative: explicit routes
 

package/dist/cli/generate-manifest.d.ts

@@ -11,7 +11,7 @@
  * Options:
  *   --app-dir <path>     Path to Next.js app directory (default: ./src/app)
  *   --pages-dir <path>   Path to Next.js pages directory (optional, scanned in addition to app-dir)
- *   --output <path>      Output file path (default: ./public/yak-routes-manifest.json)
+ *   --output <path>      Output file path (default: ./src/yak-routes-manifest.json)
  */
 export {};
 //# sourceMappingURL=generate-manifest.d.ts.map

package/dist/cli/generate-manifest.js

@@ -11,7 +11,7 @@
  * Options:
  *   --app-dir <path>     Path to Next.js app directory (default: ./src/app)
  *   --pages-dir <path>   Path to Next.js pages directory (optional, scanned in addition to app-dir)
- *   --output <path>      Output file path (default: ./public/yak-routes-manifest.json)
+ *   --output <path>      Output file path (default: ./src/yak-routes-manifest.json)
  */
 import * as fs from "node:fs";
 import * as path from "node:path";
@@ -201,7 +201,8 @@ function parseArgs() {
     const args = process.argv.slice(2);
     let appDir = "./src/app";
     let pagesDir = undefined;
-    let output = "./public/yak-routes-manifest.json";
+    // Default to ./src/yak.routes.ts - TypeScript module that gets bundled
+    let output = "./src/yak.routes.ts";
     let help = false;
     for (let i = 0; i < args.length; i++) {
         const arg = args[i];
@@ -230,7 +231,7 @@ function showHelp() {
     console.log(`
 Yak Next.js Route Manifest Generator
 
-Scans a Next.js app directory and generates a manifest of all available page routes.
+Scans a Next.js app directory and generates a TypeScript module with route definitions.
 
 Usage:
   yak-nextjs generate-manifest [options]
@@ -238,16 +239,36 @@ Usage:
 Options:
   --app-dir <path>     Path to Next.js app directory (default: ./src/app)
   --pages-dir <path>   Path to Next.js pages directory (optional)
-  --output <path>      Output file path (default: ./public/yak-routes-manifest.json)
+  --output <path>      Output file path (default: ./src/yak.routes.ts)
   --help, -h           Show this help message
 
 Examples:
   yak-nextjs generate-manifest
   yak-nextjs generate-manifest --app-dir ./app
-  yak-nextjs generate-manifest --pages-dir ./src/pages
-  yak-nextjs generate-manifest --app-dir ./app --pages-dir ./pages
+  yak-nextjs generate-manifest --output ./src/generated/yak.routes.ts
   `);
 }
+/**
+ * Generate TypeScript module content
+ */
+function generateTypeScriptModule(routes) {
+    const routesJson = JSON.stringify(routes, null, 2);
+    return `/**
+ * Auto-generated by yak-nextjs generate-manifest
+ * DO NOT EDIT - This file is regenerated at build time
+ * 
+ * Generated: ${new Date().toISOString()}
+ */
+
+import type { RouteInfo } from "@yak-io/nextjs/server";
+
+/**
+ * All scanned routes from your Next.js application.
+ * Use with createRouteManifestAdapter for filtering options.
+ */
+export const routes: RouteInfo[] = ${routesJson} as const;
+`;
+}
 /**
  * Main entry point
  */
@@ -284,15 +305,17 @@ function main() {
         process.exit(1);
     }
     // Deduplicate routes by path (app router takes precedence)
-    const uniqueRoutes = Array.from(new Map(routes.map(r => [r.path, r])).values());
-    const manifest = {
-        routes: uniqueRoutes.sort((a, b) => a.path.localeCompare(b.path)),
-        generated_at: new Date().toISOString(),
-    };
+    const uniqueRoutes = Array.from(new Map(routes.map(r => [r.path, r])).values()).sort((a, b) => a.path.localeCompare(b.path));
     const outputPath = path.resolve(process.cwd(), output);
-    // Write JSON manifest
-    fs.writeFileSync(outputPath, JSON.stringify(manifest, null, 2), "utf-8");
-    console.log(`✅ Generated manifest with ${uniqueRoutes.length} page routes`);
+    // Ensure output directory exists
+    const outputDir = path.dirname(outputPath);
+    if (!fs.existsSync(outputDir)) {
+        fs.mkdirSync(outputDir, { recursive: true });
+    }
+    // Write TypeScript module
+    const content = generateTypeScriptModule(uniqueRoutes);
+    fs.writeFileSync(outputPath, content, "utf-8");
+    console.log(`✅ Generated route manifest with ${uniqueRoutes.length} routes`);
     console.log(`   Output: ${outputPath}`);
 }
 // Run the CLI

package/dist/server/createNextYakHandler.d.ts

@@ -3,6 +3,7 @@ import type { RouteSourceInput, ToolSourceInput, RouteInfo, RouteManifest, ToolM
  * Load a pre-built route manifest from disk (JSON file).
  *
  * This works in traditional Node.js deployments where the filesystem is available.
+ * For Vercel serverless, the manifest must be imported directly in your route file.
  *
  * Generate the manifest at build time using:
  *   yak-nextjs generate-manifest

package/dist/server/createNextYakHandler.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"createNextYakHandler.d.ts","sourceRoot":"","sources":["../../src/server/createNextYakHandler.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EACV,gBAAgB,EAChB,eAAe,EACf,SAAS,EACT,aAAa,EACb,YAAY,EACZ,YAAY,EACb,MAAM,2BAA2B,CAAC;AAiBnC;;;;;;;;;;GAUG;AACH,wBAAgB,iBAAiB,CAAC,YAAY,CAAC,EAAE,MAAM,GAAG,aAAa,GAAG,IAAI,CAgB7E;AAgED;;;GAGG;AACH,wBAAgB,UAAU,CAAC,YAAY,CAAC,EAAE,MAAM,GAAG,SAAS,EAAE,CAe7D;AAED,MAAM,MAAM,kBAAkB,GAAG;IAC/B,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;CACpB,CAAC;AAEF,MAAM,MAAM,oBAAoB,GAAG;IACjC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,WAAW,CAAC,EAAE,kBAAkB,CAAC;IACjC,MAAM,CAAC,EAAE,gBAAgB,CAAC;IAC1B,SAAS,CAAC,EAAE,MAAM,OAAO,CAAC,SAAS,EAAE,CAAC,CAAC;IACvC,KAAK,CAAC,EAAE,eAAe,CAAC;IACxB,QAAQ,CAAC,EAAE,MAAM,GAAG,KAAK,CAAC;IAC1B,QAAQ,CAAC,EAAE,MAAM,OAAO,CAAC,YAAY,CAAC,CAAC;IACvC,WAAW,CAAC,EAAE,YAAY,CAAC;CAC5B,CAAC;AAEF;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,oBAAoB;;;EAKhE;AAmGD,MAAM,MAAM,0BAA0B,GAAG;IACvC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,WAAW,CAAC,EAAE,kBAAkB,CAAC;IACjC,MAAM,CAAC,EAAE,gBAAgB,CAAC;IAC1B,SAAS,CAAC,EAAE,MAAM,OAAO,CAAC,SAAS,EAAE,CAAC,CAAC;IACvC,KAAK,CAAC,EAAE,eAAe,CAAC;IACxB,QAAQ,CAAC,EAAE,MAAM,OAAO,CAAC,YAAY,CAAC,CAAC;CACxC,CAAC;AAEF,wBAAgB,0BAA0B,CAAC,MAAM,EAAE,0BAA0B,wCAK5E;AAED,MAAM,MAAM,yBAAyB,GAAG;IACtC,KAAK,CAAC,EAAE,eAAe,CAAC;IACxB,QAAQ,CAAC,EAAE,MAAM,OAAO,CAAC,YAAY,CAAC,CAAC;IACvC,WAAW,EAAE,YAAY,CAAC;CAC3B,CAAC;AAEF,wBAAgB,yBAAyB,CAAC,MAAM,EAAE,yBAAyB,uCAW1E"}
+{"version":3,"file":"createNextYakHandler.d.ts","sourceRoot":"","sources":["../../src/server/createNextYakHandler.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EACV,gBAAgB,EAChB,eAAe,EACf,SAAS,EACT,aAAa,EACb,YAAY,EACZ,YAAY,EACb,MAAM,2BAA2B,CAAC;AAkBnC;;;;;;;;;;;GAWG;AACH,wBAAgB,iBAAiB,CAAC,YAAY,CAAC,EAAE,MAAM,GAAG,aAAa,GAAG,IAAI,CAgB7E;AAED;;;GAGG;AACH,wBAAgB,UAAU,CAAC,YAAY,CAAC,EAAE,MAAM,GAAG,SAAS,EAAE,CAe7D;AAED,MAAM,MAAM,kBAAkB,GAAG;IAC/B,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;CACpB,CAAC;AAEF,MAAM,MAAM,oBAAoB,GAAG;IACjC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,WAAW,CAAC,EAAE,kBAAkB,CAAC;IACjC,MAAM,CAAC,EAAE,gBAAgB,CAAC;IAC1B,SAAS,CAAC,EAAE,MAAM,OAAO,CAAC,SAAS,EAAE,CAAC,CAAC;IACvC,KAAK,CAAC,EAAE,eAAe,CAAC;IACxB,QAAQ,CAAC,EAAE,MAAM,GAAG,KAAK,CAAC;IAC1B,QAAQ,CAAC,EAAE,MAAM,OAAO,CAAC,YAAY,CAAC,CAAC;IACvC,WAAW,CAAC,EAAE,YAAY,CAAC;CAC5B,CAAC;AAEF;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,oBAAoB;;;EAKhE;AA0FD,MAAM,MAAM,0BAA0B,GAAG;IACvC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,WAAW,CAAC,EAAE,kBAAkB,CAAC;IACjC,MAAM,CAAC,EAAE,gBAAgB,CAAC;IAC1B,SAAS,CAAC,EAAE,MAAM,OAAO,CAAC,SAAS,EAAE,CAAC,CAAC;IACvC,KAAK,CAAC,EAAE,eAAe,CAAC;IACxB,QAAQ,CAAC,EAAE,MAAM,OAAO,CAAC,YAAY,CAAC,CAAC;CACxC,CAAC;AAEF,wBAAgB,0BAA0B,CAAC,MAAM,EAAE,0BAA0B,wCAK5E;AAED,MAAM,MAAM,yBAAyB,GAAG;IACtC,KAAK,CAAC,EAAE,eAAe,CAAC;IACxB,QAAQ,CAAC,EAAE,MAAM,OAAO,CAAC,YAAY,CAAC,CAAC;IACvC,WAAW,EAAE,YAAY,CAAC;CAC3B,CAAC;AAEF,wBAAgB,yBAAyB,CAAC,MAAM,EAAE,yBAAyB,uCAW1E"}

package/dist/server/createNextYakHandler.js

@@ -5,19 +5,22 @@ import { scanRoutes } from "./scan-routes.js";
 /**
  * Default paths to check for pre-built route manifests (JSON files).
  * These are read via fs.readFileSync at runtime.
+ *
+ * Priority:
+ * 1. ./src/yak-routes-manifest.json - Default output, bundled by Next.js file tracing
+ * 2. ./yak-routes-manifest.json - Root fallback
+ * 3. ./public/yak-routes-manifest.json - Legacy location (doesn't work on Vercel serverless)
  */
 const DEFAULT_MANIFEST_PATHS = [
-    "./public/yak-routes-manifest.json",
+    "./src/yak-routes-manifest.json",
     "./yak-routes-manifest.json",
+    "./public/yak-routes-manifest.json",
 ];
-/**
- * Public URL path where the manifest is served from (when in public/).
- */
-const PUBLIC_MANIFEST_URL = "/yak-routes-manifest.json";
 /**
  * Load a pre-built route manifest from disk (JSON file).
  *
  * This works in traditional Node.js deployments where the filesystem is available.
+ * For Vercel serverless, the manifest must be imported directly in your route file.
  *
  * Generate the manifest at build time using:
  *   yak-nextjs generate-manifest
@@ -41,59 +44,6 @@ export function loadRouteManifest(manifestPath) {
     }
     return null;
 }
-/**
- * Fetch the route manifest from the public URL.
- * Used in serverless environments where filesystem access is not available.
- */
-async function fetchRouteManifest() {
-    // Try to determine the base URL for fetching
-    const baseUrl = getBaseUrl();
-    if (!baseUrl) {
-        return null;
-    }
-    try {
-        const url = new URL(PUBLIC_MANIFEST_URL, baseUrl);
-        const response = await fetch(url.toString(), {
-            headers: { "Accept": "application/json" },
-            cache: "no-store",
-        });
-        if (!response.ok) {
-            return null;
-        }
-        const manifest = await response.json();
-        if (manifest?.routes) {
-            return manifest;
-        }
-    }
-    catch {
-        // Fetch failed
-    }
-    return null;
-}
-/**
- * Get the base URL for the current deployment.
- * Supports Vercel, Netlify, and custom configurations.
- */
-function getBaseUrl() {
-    // Vercel provides VERCEL_URL (without protocol)
-    if (process.env.VERCEL_URL) {
-        const protocol = process.env.VERCEL_ENV === "development" ? "http" : "https";
-        return `${protocol}://${process.env.VERCEL_URL}`;
-    }
-    // Netlify provides URL
-    if (process.env.URL) {
-        return process.env.URL;
-    }
-    // Custom base URL
-    if (process.env.NEXT_PUBLIC_BASE_URL) {
-        return process.env.NEXT_PUBLIC_BASE_URL;
-    }
-    // For local development
-    if (process.env.NODE_ENV === "development") {
-        return "http://localhost:3000";
-    }
-    return null;
-}
 /**
  * Load routes from a pre-built manifest.
  * Throws if manifest is not found.
@@ -138,22 +88,14 @@ async function tryLoadRoutes(appDir) {
     if (manifest) {
         return manifest.routes;
     }
-    // Try fetching from public URL (works on Vercel/serverless)
-    const fetchedManifest = await fetchRouteManifest();
-    if (fetchedManifest) {
-        return fetchedManifest.routes;
-    }
     // Neither source nor manifest available - provide helpful error
-    throw new Error(`App directory not found: ${targetDir}\n\n` +
-        `This typically happens in production (Vercel, etc.) where source files aren't deployed.\n\n` +
-        `Solutions:\n` +
-        `1. Generate a route manifest at build time (recommended):\n` +
-        `   Add to package.json: "prebuild": "yak-nextjs generate-manifest"\n` +
-        `   The manifest will be placed in public/ and automatically loaded.\n\n` +
-        `2. Provide routes explicitly:\n` +
-        `   createNextYakHandler({ routes: [{ path: "/", title: "Home" }, ...] })\n\n` +
-        `3. Use getRoutes callback:\n` +
-        `   createNextYakHandler({ getRoutes: async () => [...] })`);
+    throw new Error(`Route manifest not found.\n\n` +
+        `Generate the manifest at build time by adding to package.json:\n` +
+        `  "prebuild": "yak-nextjs generate-manifest"\n\n` +
+        `The manifest will be created at ./src/yak-routes-manifest.json and automatically\n` +
+        `bundled with your serverless function.\n\n` +
+        `Alternatively, provide routes explicitly:\n` +
+        `  createNextYakHandler({ routes: [{ path: "/", title: "Home" }] })`);
 }
 function resolveRouteSources(config) {
     if (config.routes) {

package/dist/server/index.d.ts

@@ -2,5 +2,7 @@ export { scanRoutes } from "./scan-routes.js";
 export type { ScanRoutesOptions } from "./scan-routes.js";
 export { createNextYakHandler, createNextYakConfigHandler, createNextYakToolsHandler, loadRouteManifest, loadRoutes, } from "./createNextYakHandler.js";
 export type { NextYakHandlerConfig, NextYakConfigHandlerConfig, NextYakToolsHandlerConfig, NextYakRouteFilter, } from "./createNextYakHandler.js";
+export { createRouteManifestAdapter } from "./route-manifest-adapter.js";
+export type { RouteManifestAdapterConfig } from "./route-manifest-adapter.js";
 export type { ToolExecutor, ToolCallPayload, ToolCallResult, ToolDefinition, ToolManifest, RouteInfo, RouteManifest, ChatConfig, } from "@yak-io/javascript/server";
 //# sourceMappingURL=index.d.ts.map

package/dist/server/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/server/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,YAAY,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAE1D,OAAO,EACN,oBAAoB,EACpB,0BAA0B,EAC1B,yBAAyB,EACzB,iBAAiB,EACjB,UAAU,GACV,MAAM,2BAA2B,CAAC;AACnC,YAAY,EACX,oBAAoB,EACpB,0BAA0B,EAC1B,yBAAyB,EACzB,kBAAkB,GAClB,MAAM,2BAA2B,CAAC;AAEnC,YAAY,EACX,YAAY,EACZ,eAAe,EACf,cAAc,EACd,cAAc,EACd,YAAY,EACZ,SAAS,EACT,aAAa,EACb,UAAU,GACV,MAAM,2BAA2B,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/server/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,YAAY,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAE1D,OAAO,EACN,oBAAoB,EACpB,0BAA0B,EAC1B,yBAAyB,EACzB,iBAAiB,EACjB,UAAU,GACV,MAAM,2BAA2B,CAAC;AACnC,YAAY,EACX,oBAAoB,EACpB,0BAA0B,EAC1B,yBAAyB,EACzB,kBAAkB,GAClB,MAAM,2BAA2B,CAAC;AAEnC,OAAO,EAAE,0BAA0B,EAAE,MAAM,6BAA6B,CAAC;AACzE,YAAY,EAAE,0BAA0B,EAAE,MAAM,6BAA6B,CAAC;AAE9E,YAAY,EACX,YAAY,EACZ,eAAe,EACf,cAAc,EACd,cAAc,EACd,YAAY,EACZ,SAAS,EACT,aAAa,EACb,UAAU,GACV,MAAM,2BAA2B,CAAC"}

package/dist/server/index.js

@@ -1,2 +1,3 @@
 export { scanRoutes } from "./scan-routes.js";
 export { createNextYakHandler, createNextYakConfigHandler, createNextYakToolsHandler, loadRouteManifest, loadRoutes, } from "./createNextYakHandler.js";
+export { createRouteManifestAdapter } from "./route-manifest-adapter.js";

package/dist/server/route-manifest-adapter.d.ts

@@ -0,0 +1,73 @@
+import type { RouteInfo, RouteSource } from "@yak-io/javascript/server";
+/**
+ * Configuration for creating a route manifest adapter
+ */
+export type RouteManifestAdapterConfig = {
+    /**
+     * The routes from the generated manifest.
+     * Import from the generated file: `import { routes } from "@/yak.routes"`
+     */
+    routes: RouteInfo[];
+    /**
+     * Optional ID for this route source (default: "manifest")
+     */
+    id?: string;
+    /**
+     * List of allowed route paths, e.g. ["/", "/docs", "/pricing"].
+     * Supports exact matches and prefix patterns ending with `*`.
+     * If provided, only these routes will be included.
+     * If omitted, all routes are allowed by default.
+     *
+     * @example
+     * ```ts
+     * allowedRoutes: ["/docs/*", "/pricing", "/"]
+     * ```
+     */
+    allowedRoutes?: string[];
+    /**
+     * List of disallowed route paths, e.g. ["/admin/*", "/internal/*"].
+     * Supports exact matches and prefix patterns ending with `*`.
+     * These routes will be excluded even if they would otherwise be allowed.
+     * Applied after allowedRoutes filtering.
+     *
+     * @example
+     * ```ts
+     * disallowedRoutes: ["/admin/*", "/settings/billing"]
+     * ```
+     */
+    disallowedRoutes?: string[];
+};
+/**
+ * Create a route source adapter from an imported route manifest.
+ *
+ * This adapter allows you to use generated route manifests with optional
+ * filtering to control which routes are exposed to the chatbot.
+ *
+ * @example Basic usage - all routes
+ * ```ts
+ * import { createNextYakHandler } from "@yak-io/nextjs/server";
+ * import { createRouteManifestAdapter } from "@yak-io/nextjs/server";
+ * import { routes } from "@/yak.routes";
+ *
+ * export const { GET, POST } = createNextYakHandler({
+ *   routes: createRouteManifestAdapter({ routes }),
+ * });
+ * ```
+ *
+ * @example With filtering
+ * ```ts
+ * import { createNextYakHandler } from "@yak-io/nextjs/server";
+ * import { createRouteManifestAdapter } from "@yak-io/nextjs/server";
+ * import { routes } from "@/yak.routes";
+ *
+ * export const { GET, POST } = createNextYakHandler({
+ *   routes: createRouteManifestAdapter({
+ *     routes,
+ *     allowedRoutes: ["/docs/*", "/pricing", "/"],
+ *     disallowedRoutes: ["/docs/internal/*"],
+ *   }),
+ * });
+ * ```
+ */
+export declare function createRouteManifestAdapter(config: RouteManifestAdapterConfig): RouteSource;
+//# sourceMappingURL=route-manifest-adapter.d.ts.map

package/dist/server/route-manifest-adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"route-manifest-adapter.d.ts","sourceRoot":"","sources":["../../src/server/route-manifest-adapter.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,2BAA2B,CAAC;AAExE;;GAEG;AACH,MAAM,MAAM,0BAA0B,GAAG;IACvC;;;OAGG;IACH,MAAM,EAAE,SAAS,EAAE,CAAC;IAEpB;;OAEG;IACH,EAAE,CAAC,EAAE,MAAM,CAAC;IAEZ;;;;;;;;;;OAUG;IACH,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;IAEzB;;;;;;;;;;OAUG;IACH,gBAAgB,CAAC,EAAE,MAAM,EAAE,CAAC;CAC7B,CAAC;AAiDF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AACH,wBAAgB,0BAA0B,CACxC,MAAM,EAAE,0BAA0B,GACjC,WAAW,CASb"}

package/dist/server/route-manifest-adapter.js

@@ -0,0 +1,75 @@
+/**
+ * Check if a route path matches a pattern.
+ * Supports exact matches and prefix patterns ending with `*`.
+ */
+function matchesPattern(pattern, routePath) {
+    if (pattern.endsWith("/*")) {
+        const prefix = pattern.slice(0, -1); // Remove the *
+        return routePath === prefix.slice(0, -1) || routePath.startsWith(prefix);
+    }
+    return pattern === routePath;
+}
+/**
+ * Filter routes based on allowed and disallowed patterns.
+ */
+function filterRoutes(routes, allowedRoutes, disallowedRoutes) {
+    return routes.filter((route) => {
+        const path = route.path;
+        // If allowedRoutes is set, route must match at least one pattern
+        if (allowedRoutes && allowedRoutes.length > 0) {
+            const isAllowed = allowedRoutes.some((pattern) => matchesPattern(pattern, path));
+            if (!isAllowed) {
+                return false;
+            }
+        }
+        // If disallowedRoutes is set, route must not match any pattern
+        if (disallowedRoutes && disallowedRoutes.length > 0) {
+            const isDisallowed = disallowedRoutes.some((pattern) => matchesPattern(pattern, path));
+            if (isDisallowed) {
+                return false;
+            }
+        }
+        return true;
+    });
+}
+/**
+ * Create a route source adapter from an imported route manifest.
+ *
+ * This adapter allows you to use generated route manifests with optional
+ * filtering to control which routes are exposed to the chatbot.
+ *
+ * @example Basic usage - all routes
+ * ```ts
+ * import { createNextYakHandler } from "@yak-io/nextjs/server";
+ * import { createRouteManifestAdapter } from "@yak-io/nextjs/server";
+ * import { routes } from "@/yak.routes";
+ *
+ * export const { GET, POST } = createNextYakHandler({
+ *   routes: createRouteManifestAdapter({ routes }),
+ * });
+ * ```
+ *
+ * @example With filtering
+ * ```ts
+ * import { createNextYakHandler } from "@yak-io/nextjs/server";
+ * import { createRouteManifestAdapter } from "@yak-io/nextjs/server";
+ * import { routes } from "@/yak.routes";
+ *
+ * export const { GET, POST } = createNextYakHandler({
+ *   routes: createRouteManifestAdapter({
+ *     routes,
+ *     allowedRoutes: ["/docs/*", "/pricing", "/"],
+ *     disallowedRoutes: ["/docs/internal/*"],
+ *   }),
+ * });
+ * ```
+ */
+export function createRouteManifestAdapter(config) {
+    const { routes, id = "manifest", allowedRoutes, disallowedRoutes } = config;
+    return {
+        id,
+        getRoutes: async () => {
+            return filterRoutes(routes, allowedRoutes, disallowedRoutes);
+        },
+    };
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@yak-io/nextjs",
-  "version": "0.1.3",
+  "version": "0.1.5",
   "description": "Next.js SDK for embedding yak chatbot with route manifest generation",
   "type": "module",
   "license": "SEE LICENSE IN LICENSE",