@yak-io/nextjs 0.1.2 → 0.1.4

package/README.md

@@ -164,12 +164,12 @@ Behind the scenes `@yak-io/javascript` merges every `RouteSource` into a single
 yak-nextjs generate-manifest
 ```
 
-Use the CLI when you prefer to pre-compute a manifest at build time. The JSON matches the runtime manifest structure exposed by the handlers.
+Use the CLI to pre-compute a manifest at build time. The JSON matches the runtime manifest structure exposed by the handlers.
 
 **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: `./yak-routes-manifest.json`)
+- `--output <path>` – Output file path (default: `./public/yak-routes-manifest.json`)
 
 **Examples:**
 ```bash
@@ -182,8 +182,6 @@ yak-nextjs generate-manifest --app-dir ./app --pages-dir ./pages
 
 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:
@@ -197,22 +195,9 @@ Add a `prebuild` script to generate the manifest before Next.js builds:
 }
 ```
 
-This uses the defaults (`./src/app` → `./yak-routes-manifest.json`). Customize if needed:
-
-```json
-{
-  "scripts": {
-    "prebuild": "yak-nextjs generate-manifest --app-dir ./app --output ./routes.json"
-  }
-}
-```
-
-> **Important:** The manifest must be in the project root (not `public/`). On Vercel and other serverless platforms, files in `public/` are served via CDN and are not available on the function's filesystem.
+That's it! The manifest is generated to `./src/yak-routes-manifest.json` and automatically bundled with your serverless function. No code changes needed in your API route.
 
-The handler checks these locations automatically:
-1. `./yak-routes-manifest.json`
-2. `./.next/yak-routes-manifest.json`
-3. `./public/yak-routes-manifest.json` (only works in non-serverless environments)
+The manifest is placed in `./src/` so that Next.js file tracing includes it in the serverless bundle, making it available at runtime on platforms like Vercel.
 
 ### Alternative: explicit routes
 
@@ -227,24 +212,14 @@ export const { GET, POST } = createNextYakHandler({
 });
 ```
 
-### Loading a custom manifest location
-
-```ts
-import { createNextYakHandler, loadRoutes } from "@yak-io/nextjs/server";
-
-export const { GET, POST } = createNextYakHandler({
-  routes: loadRoutes("./custom/manifest.json"),
-});
-```
-
 ## API surface (server)
 
 `@yak-io/nextjs/server` exports:
 
 - `scanRoutes(directory: string, options?: { directoryType?: "app" | "pages" })` – low-level filesystem scanner (useful for precomputing manifests or composing custom sources). Only captures page routes, extracting `title` and `description` from static metadata exports.
-- `loadRouteManifest(path?: string)` – load a pre-built JSON manifest, returns `null` if not found. Checks `./yak-routes-manifest.json`, `./.next/yak-routes-manifest.json`, and `./public/yak-routes-manifest.json` by default.
+- `loadRouteManifest(path?: string)` – load a pre-built JSON manifest via filesystem read, returns `null` if not found.
 - `loadRoutes(path?: string)` – load routes from a manifest, throws with helpful error if not found.
-- `createNextYakHandler(config)` – unified GET + POST handler (wrapping `createYakHandler`). When `routes`/`getRoutes` are omitted it auto-scans `./src/app` and `./src/pages` (override with `appDir`/`pagesDir`, and narrow results via `routeFilter?: { include?: RegExp[]; exclude?: RegExp[] }`). In production, automatically falls back to pre-built manifests.
+- `createNextYakHandler(config)` – unified GET + POST handler. When `routes`/`getRoutes` are omitted it auto-scans `./src/app` (override with `appDir`). In production, automatically fetches manifest from public folder.
 - `createNextYakConfigHandler(config)` – GET-only convenience wrapper.
 - `createNextYakToolsHandler(config)` – POST-only wrapper.
 - Re-exported types from `@yak-io/javascript/server` (RouteInfo, RouteManifest, ToolDefinition, ToolManifest, ToolExecutor, ChatConfig, RouteSourceInput, ToolSourceInput, etc.).

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: ./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: ./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 = "./yak-routes-manifest.json";
+    // Default to ./src/ so the file is included in Next.js serverless bundle via file tracing
+    let output = "./src/yak-routes-manifest.json";
     let help = false;
     for (let i = 0; i < args.length; i++) {
         const arg = args[i];
@@ -238,7 +239,7 @@ 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: ./yak-routes-manifest.json)
+  --output <path>      Output file path (default: ./src/yak-routes-manifest.json)
   --help, -h           Show this help message
 
 Examples:
@@ -290,6 +291,7 @@ function main() {
         generated_at: new Date().toISOString(),
     };
     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`);
     console.log(`   Output: ${outputPath}`);

package/dist/server/createNextYakHandler.d.ts

@@ -1,9 +1,9 @@
 import type { RouteSourceInput, ToolSourceInput, RouteInfo, RouteManifest, ToolManifest, ToolExecutor } from "@yak-io/javascript/server";
 /**
- * Load a pre-built route manifest from disk.
+ * Load a pre-built route manifest from disk (JSON file).
  *
- * This should be used in production environments where filesystem scanning
- * is not available (e.g., Vercel serverless functions).
+ * 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;AAgBnC;;;;;;;;;;;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,CAa7D;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;AA6FD,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

@@ -3,22 +3,24 @@ import * as fs from "node:fs";
 import * as path from "node:path";
 import { scanRoutes } from "./scan-routes.js";
 /**
- * Default paths to check for pre-built route manifests.
+ * Default paths to check for pre-built route manifests (JSON files).
+ * These are read via fs.readFileSync at runtime.
  *
- * On Vercel/serverless, files in `public/` are served via CDN and NOT available
- * on the function's filesystem. The manifest must be in the project root or
- * another location that gets bundled with the serverless function.
+ * 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 = [
+    "./src/yak-routes-manifest.json",
     "./yak-routes-manifest.json",
-    "./.next/yak-routes-manifest.json",
-    "./public/yak-routes-manifest.json", // Only works in non-serverless environments
+    "./public/yak-routes-manifest.json",
 ];
 /**
- * Load a pre-built route manifest from disk.
+ * Load a pre-built route manifest from disk (JSON file).
  *
- * This should be used in production environments where filesystem scanning
- * is not available (e.g., Vercel serverless functions).
+ * 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
@@ -49,7 +51,9 @@ export function loadRouteManifest(manifestPath) {
 export function loadRoutes(manifestPath) {
     const manifest = loadRouteManifest(manifestPath);
     if (!manifest) {
-        const pathsChecked = manifestPath ? manifestPath : DEFAULT_MANIFEST_PATHS.join(", ");
+        const pathsChecked = manifestPath
+            ? manifestPath
+            : [...DEFAULT_MANIFEST_PATHS].join(", ");
         throw new Error(`Route manifest not found. Checked: ${pathsChecked}\n\n` +
             `In production environments (like Vercel), route scanning requires a pre-built manifest.\n` +
             `Generate it at build time by adding to your build script:\n\n` +
@@ -68,32 +72,30 @@ export function createNextYakHandler(config) {
     });
 }
 /**
- * Attempt to scan routes from filesystem, with production-safe fallback.
+ * Attempt to load routes from filesystem or fetch from public URL.
  *
  * In development: scans the app directory directly
- * In production (Vercel, etc.): falls back to pre-built manifest if directory doesn't exist
+ * In production (Vercel, etc.): falls back to pre-built manifest via filesystem or HTTP fetch
  */
-function tryLoadRoutes(appDir) {
+async function tryLoadRoutes(appDir) {
     const targetDir = path.resolve(process.cwd(), appDir);
     // If the app directory exists, scan it directly (development mode)
     if (fs.existsSync(targetDir)) {
         return scanRoutes(appDir);
     }
-    // In production, the source directory doesn't exist - try loading from manifest
+    // In production, the source directory doesn't exist - try loading from manifest file
     const manifest = loadRouteManifest();
     if (manifest) {
         return manifest.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:\n` +
-        `   Add to your build script: yak-nextjs generate-manifest\n\n` +
-        `2. Provide routes explicitly:\n` +
-        `   createNextYakHandler({ routes: [...] })\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) {
@@ -102,7 +104,10 @@ function resolveRouteSources(config) {
     if (config.getRoutes) {
         return config.getRoutes;
     }
-    return async () => applyRouteFilters(tryLoadRoutes(config.appDir ?? "./src/app"), config.routeFilter);
+    return async () => {
+        const routes = await tryLoadRoutes(config.appDir ?? "./src/app");
+        return applyRouteFilters(routes, config.routeFilter);
+    };
 }
 function applyRouteFilters(routes, filter) {
     if (!filter) {

package/package.json

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