@yak-io/nextjs 0.1.4 → 0.1.6

package/README.md

@@ -164,18 +164,18 @@ 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
@@ -184,7 +184,7 @@ During local development, routes are scanned directly from the filesystem—no s
 
 ### 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
 {
@@ -195,9 +195,35 @@ Add a `prebuild` script to generate the manifest before Next.js builds:
 }
 ```
 
-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.
+2. Use the route manifest adapter in your handler:
 
-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.
+```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/*"],
+})
+```
+
+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.js

@@ -201,8 +201,8 @@ function parseArgs() {
     const args = process.argv.slice(2);
     let appDir = "./src/app";
     let pagesDir = undefined;
-    // Default to ./src/ so the file is included in Next.js serverless bundle via file tracing
-    let output = "./src/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];
@@ -231,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]
@@ -239,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: ./src/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
  */
@@ -285,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/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.4",
+  "version": "0.1.6",
   "description": "Next.js SDK for embedding yak chatbot with route manifest generation",
   "type": "module",
   "license": "SEE LICENSE IN LICENSE",
@@ -30,23 +30,38 @@
     "LICENSE"
   ],
   "sideEffects": false,
+  "main": "./dist/index.client.js",
+  "module": "./dist/index.client.js",
+  "types": "./dist/index.client.d.ts",
   "exports": {
     "./client": {
       "types": "./dist/index.client.d.ts",
-      "import": "./dist/index.client.js"
+      "import": "./dist/index.client.js",
+      "default": "./dist/index.client.js"
     },
     "./server": {
       "types": "./dist/index.server.d.ts",
-      "import": "./dist/index.server.js"
+      "import": "./dist/index.server.js",
+      "default": "./dist/index.server.js"
     },
     "./package.json": "./package.json"
   },
+  "typesVersions": {
+    "*": {
+      "client": [
+        "./dist/index.client.d.ts"
+      ],
+      "server": [
+        "./dist/index.server.d.ts"
+      ]
+    }
+  },
   "bin": {
     "yak-nextjs": "./dist/cli/generate-manifest.js"
   },
   "dependencies": {
-    "@yak-io/javascript": "0.1.0",
-    "@yak-io/react": "0.1.0"
+    "@yak-io/javascript": "0.1.1",
+    "@yak-io/react": "0.1.1"
   },
   "peerDependencies": {
     "next": "^14.0.0 || ^15.0.0",