@yak-io/nextjs 0.3.0 → 0.3.2

package/README.md

@@ -46,7 +46,7 @@ export default function RootLayout({ children }: { children: React.ReactNode })
 ### 2. Unified API route
 
 ```ts
-// app/api/yak/[...yak]/route.ts
+// app/api/yak/[[...yak]]/route.ts
 import { createNextYakHandler } from "@yak-io/nextjs/server";
 
 export const { GET, POST } = createNextYakHandler({
@@ -178,11 +178,13 @@ yak-nextjs generate-manifest --pages-dir ./src/pages
 yak-nextjs generate-manifest --app-dir ./app --output ./src/generated/routes.ts
 ```
 
-## Route Manifest for Production
+## Route Manifest for Production (Required)
 
-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.
+> **Important:** This setup is required for production deployments. Skip this only if you are providing your own custom routes via the `routes` or `getRoutes` options.
 
-### Recommended setup
+During local development, routes are scanned directly from the filesystem. 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, causing route discovery to fail.
+
+### Required setup
 
 1. Add a `prebuild` script to generate the manifest before Next.js builds:
 
@@ -195,18 +197,49 @@ During local development, routes are scanned directly from the filesystem—no s
 }
 ```
 
-2. Use the route manifest adapter in your handler:
+The CLI auto-detects your directory structure. If your project uses non-standard paths, specify them explicitly:
+
+```json
+{
+  "scripts": {
+    "prebuild": "yak-nextjs generate-manifest --app-dir ./app --output ./app/yak.routes.ts",
+    "build": "next build"
+  }
+}
+```
+
+| Project structure | Command |
+|-------------------|-------------------------------------------------------|
+| `src/app/` (default) | `yak-nextjs generate-manifest` |
+| `app/` | `yak-nextjs generate-manifest --app-dir ./app --output ./app/yak.routes.ts` |
+| `src/app/` + `src/pages/` | `yak-nextjs generate-manifest --pages-dir ./src/pages` |
+| `app/` + `pages/` | `yak-nextjs generate-manifest --app-dir ./app --pages-dir ./pages --output ./app/yak.routes.ts` |
+
+2. Add the generated file to `.gitignore`:
+
+```gitignore
+# Generated route manifest (use the path matching your --output)
+src/yak.routes.ts
+# or for root app/ directory:
+# app/yak.routes.ts
+```
+
+3. Use the route manifest adapter in your handler:
 
 ```ts
-// app/api/yak/[...yak]/route.ts
+// app/api/yak/[[...yak]]/route.ts
 import { createNextYakHandler, createRouteManifestAdapter } from "@yak-io/nextjs/server";
-import { routes } from "@/yak.routes";
+import { routes } from "@/yak.routes"; // Adjust path based on your tsconfig paths
 
 export const { GET, POST } = createNextYakHandler({
   routes: createRouteManifestAdapter({ routes }),
 });
 ```
 
+> **Note:** The import path depends on your `tsconfig.json` paths. Common configurations:
+> - `src/yak.routes.ts` → `@/yak.routes` (when `@/*` maps to `./src/*`)
+> - `app/yak.routes.ts` → `@/yak.routes` (when `@/*` maps to `./app/*`) or `../../../yak.routes`
+
 The generated TypeScript module is imported directly, ensuring it's bundled with your serverless function automatically.
 
 ### Route filtering

package/dist/cli/generate-manifest.js

@@ -70,7 +70,10 @@ function isRequiredCatchAll(segment) {
  * Check if a path segment is a dynamic segment (e.g., [id])
  */
 function isDynamicSegment(segment) {
-    return segment.startsWith("[") && segment.endsWith("]") && !isOptionalCatchAll(segment) && !isRequiredCatchAll(segment);
+    return (segment.startsWith("[") &&
+        segment.endsWith("]") &&
+        !isOptionalCatchAll(segment) &&
+        !isRequiredCatchAll(segment));
 }
 /**
  * Normalize a dynamic segment for display
@@ -88,8 +91,8 @@ function normalizeRoutePath(segments) {
     // Filter out route groups - they don't appear in URLs
     // Filter out optional catch-all segments - they match the base path
     const urlSegments = segments
-        .filter(seg => !isRouteGroup(seg) && !isOptionalCatchAll(seg))
-        .map(seg => {
+        .filter((seg) => !isRouteGroup(seg) && !isOptionalCatchAll(seg))
+        .map((seg) => {
         if (isDynamicSegment(seg)) {
             return normalizeDynamicSegment(seg);
         }
@@ -102,7 +105,7 @@ function normalizeRoutePath(segments) {
     });
     if (urlSegments.length === 0)
         return "/";
-    return "/" + urlSegments.join("/");
+    return `/${urlSegments.join("/")}`;
 }
 /**
  * Check if file is a page file
@@ -146,10 +149,19 @@ function scanDirectory(dirPath, segments = []) {
  * File discovery helpers for legacy `pages/` directories
  */
 const VALID_PAGE_EXTENSIONS = new Set([".js", ".jsx", ".ts", ".tsx", ".md", ".mdx"]);
-const SPECIAL_PAGE_FILENAMES = new Set(["_app", "_document", "_error", "404", "500", "middleware", "_middleware"]);
+const SPECIAL_PAGE_FILENAMES = new Set([
+    "_app",
+    "_document",
+    "_error",
+    "404",
+    "500",
+    "middleware",
+    "_middleware",
+]);
 /**
  * Recursively scan a pages directory for Next.js page routes
  */
+// biome-ignore lint/complexity/noExcessiveCognitiveComplexity: recursive directory scanner with multiple file type checks
 function scanPagesDirectory(dirPath, segments = []) {
     const routes = [];
     try {
@@ -200,7 +212,7 @@ function buildPagesSegments(segments, baseName) {
 function parseArgs() {
     const args = process.argv.slice(2);
     let appDir = "./src/app";
-    let pagesDir = undefined;
+    let pagesDir;
     // Default to ./src/yak.routes.ts - TypeScript module that gets bundled
     let output = "./src/yak.routes.ts";
     let help = false;
@@ -305,7 +317,7 @@ 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()).sort((a, b) => a.path.localeCompare(b.path));
+    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);
     // Ensure output directory exists
     const outputDir = path.dirname(outputPath);

package/dist/client/YakProvider.d.ts

@@ -1,4 +1,4 @@
-import React from "react";
+import type React from "react";
 import { type YakProviderProps as CoreYakProviderProps } from "@yak-io/react";
 export type YakProviderProps = CoreYakProviderProps;
 /**

package/dist/client/YakProvider.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"YakProvider.d.ts","sourceRoot":"","sources":["../../src/client/YakProvider.tsx"],"names":[],"mappings":"AAEA,OAAO,KAA+B,MAAM,OAAO,CAAC;AAEpD,OAAO,EAEL,KAAK,gBAAgB,IAAI,oBAAoB,EAC9C,MAAM,eAAe,CAAC;AAEvB,MAAM,MAAM,gBAAgB,GAAG,oBAAoB,CAAC;AAkCpD;;;;;;;;;GASG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,gBAAgB,GAAG,KAAK,CAAC,GAAG,CAAC,OAAO,CAiCtE"}
+{"version":3,"file":"YakProvider.d.ts","sourceRoot":"","sources":["../../src/client/YakProvider.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAG/B,OAAO,EAEL,KAAK,gBAAgB,IAAI,oBAAoB,EAC9C,MAAM,eAAe,CAAC;AAEvB,MAAM,MAAM,gBAAgB,GAAG,oBAAoB,CAAC;AAkCpD;;;;;;;;;GASG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,gBAAgB,GAAG,KAAK,CAAC,GAAG,CAAC,OAAO,CA2BtE"}

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;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"}
+{"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,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;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,uCAY1E"}

package/dist/server/createNextYakHandler.js

@@ -51,14 +51,12 @@ 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` +
-            `  yak-nextjs generate-manifest\n\n` +
-            `Or provide routes explicitly in your handler configuration.`);
+            "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" +
+            "  yak-nextjs generate-manifest\n\n" +
+            "Or provide routes explicitly in your handler configuration.");
     }
     return manifest.routes;
 }
@@ -89,12 +87,12 @@ async function tryLoadRoutes(appDir) {
         return manifest.routes;
     }
     // Neither source nor manifest available - provide helpful error
-    throw new Error(`Route manifest not found.\n\n` +
-        `Generate the manifest at build time by adding to package.json:\n` +
+    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` +
+        "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) {
@@ -114,12 +112,12 @@ function applyRouteFilters(routes, filter) {
         return routes;
     }
     const { include = [], exclude = [] } = filter;
-    return routes.filter(route => {
+    return routes.filter((route) => {
         const path = route.path;
-        if (include.length > 0 && !include.some(pattern => matches(pattern, path))) {
+        if (include.length > 0 && !include.some((pattern) => matches(pattern, path))) {
             return false;
         }
-        if (exclude.some(pattern => matches(pattern, path))) {
+        if (exclude.some((pattern) => matches(pattern, path))) {
             return false;
         }
         return true;
@@ -155,6 +153,7 @@ export function createNextYakToolsHandler(config) {
         throw new Error("createNextYakToolsHandler requires either 'tools' or 'getTools'");
     }
     const toolSource = config.tools ?? {
+        // getTools is guaranteed to be defined here since we check above
         getTools: config.getTools,
         executeTool: config.executeTool,
     };

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,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"}
+{"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,EACL,oBAAoB,EACpB,0BAA0B,EAC1B,yBAAyB,EACzB,iBAAiB,EACjB,UAAU,GACX,MAAM,2BAA2B,CAAC;AACnC,YAAY,EACV,oBAAoB,EACpB,0BAA0B,EAC1B,yBAAyB,EACzB,kBAAkB,GACnB,MAAM,2BAA2B,CAAC;AAEnC,OAAO,EAAE,0BAA0B,EAAE,MAAM,6BAA6B,CAAC;AACzE,YAAY,EAAE,0BAA0B,EAAE,MAAM,6BAA6B,CAAC;AAE9E,YAAY,EACV,YAAY,EACZ,eAAe,EACf,cAAc,EACd,cAAc,EACd,YAAY,EACZ,SAAS,EACT,aAAa,EACb,UAAU,GACX,MAAM,2BAA2B,CAAC"}

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

@@ -1 +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"}
+{"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;AA6CF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AACH,wBAAgB,0BAA0B,CAAC,MAAM,EAAE,0BAA0B,GAAG,WAAW,CAS1F"}

package/dist/server/scan-routes.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"scan-routes.d.ts","sourceRoot":"","sources":["../../src/server/scan-routes.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,2BAA2B,CAAC;AAE3D,MAAM,MAAM,iBAAiB,GAAG;IAC9B,aAAa,CAAC,EAAE,KAAK,GAAG,OAAO,CAAC;CACjC,CAAC;AA8NF;;GAEG;AACH,wBAAgB,UAAU,CACxB,SAAS,EAAE,MAAM,EACjB,OAAO,CAAC,EAAE,iBAAiB,GAC1B,SAAS,EAAE,CAcb"}
+{"version":3,"file":"scan-routes.d.ts","sourceRoot":"","sources":["../../src/server/scan-routes.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,2BAA2B,CAAC;AAE3D,MAAM,MAAM,iBAAiB,GAAG;IAC9B,aAAa,CAAC,EAAE,KAAK,GAAG,OAAO,CAAC;CACjC,CAAC;AAsOF;;GAEG;AACH,wBAAgB,UAAU,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,iBAAiB,GAAG,SAAS,EAAE,CActF"}

package/dist/server/scan-routes.js

@@ -55,7 +55,10 @@ function isRequiredCatchAll(segment) {
  * Check if a path segment is a dynamic segment (e.g., [id])
  */
 function isDynamicSegment(segment) {
-    return segment.startsWith("[") && segment.endsWith("]") && !isOptionalCatchAll(segment) && !isRequiredCatchAll(segment);
+    return (segment.startsWith("[") &&
+        segment.endsWith("]") &&
+        !isOptionalCatchAll(segment) &&
+        !isRequiredCatchAll(segment));
 }
 /**
  * Normalize a dynamic segment for display
@@ -73,8 +76,8 @@ function normalizeRoutePath(segments) {
     // Filter out route groups - they don't appear in URLs
     // Filter out optional catch-all segments - they match the base path
     const urlSegments = segments
-        .filter(seg => !isRouteGroup(seg) && !isOptionalCatchAll(seg))
-        .map(seg => {
+        .filter((seg) => !isRouteGroup(seg) && !isOptionalCatchAll(seg))
+        .map((seg) => {
         if (isDynamicSegment(seg)) {
             return normalizeDynamicSegment(seg);
         }
@@ -87,7 +90,7 @@ function normalizeRoutePath(segments) {
     });
     if (urlSegments.length === 0)
         return "/";
-    return "/" + urlSegments.join("/");
+    return `/${urlSegments.join("/")}`;
 }
 /**
  * Check if file is a page file
@@ -131,7 +134,16 @@ function scanAppDirectory(dirPath, segments = []) {
  * File discovery helpers for legacy `pages/` directories
  */
 const VALID_PAGE_EXTENSIONS = new Set([".js", ".jsx", ".ts", ".tsx", ".md", ".mdx"]);
-const SPECIAL_PAGE_FILENAMES = new Set(["_app", "_document", "_error", "404", "500", "middleware", "_middleware"]);
+const SPECIAL_PAGE_FILENAMES = new Set([
+    "_app",
+    "_document",
+    "_error",
+    "404",
+    "500",
+    "middleware",
+    "_middleware",
+]);
+// biome-ignore lint/complexity/noExcessiveCognitiveComplexity: recursive directory scanner with multiple file type checks
 function scanPagesDirectory(dirPath, segments = []) {
     const routes = [];
     try {

package/package.json

@@ -1,13 +1,13 @@
 {
   "name": "@yak-io/nextjs",
-  "version": "0.3.0",
+  "version": "0.3.2",
   "description": "Next.js SDK for embedding yak chatbot with route manifest generation",
   "type": "module",
   "license": "SEE LICENSE IN LICENSE",
   "author": "Yak <support@yak.io>",
   "repository": {
     "type": "git",
-    "url": "https://github.com/9f-au/yak.git",
+    "url": "https://github.com/388-labs/yak.git",
     "directory": "packages/nextjs"
   },
   "publishConfig": {
@@ -60,8 +60,8 @@
     "yak-nextjs": "./dist/cli/generate-manifest.js"
   },
   "dependencies": {
-    "@yak-io/javascript": "0.3.0",
-    "@yak-io/react": "0.3.0"
+    "@yak-io/javascript": "0.4.1",
+    "@yak-io/react": "0.4.1"
   },
   "peerDependencies": {
     "next": "^14.0.0 || ^15.0.0 || ^16.0.0",
@@ -69,17 +69,19 @@
     "react-dom": "^18.0.0 || ^19.0.0"
   },
   "devDependencies": {
-    "@types/node": "^24.10.2",
-    "@types/react": "^19.2.7",
+    "@types/node": "^24.10.4",
+    "@types/react": "^19.2.14",
     "@types/react-dom": "^19.2.0",
-    "next": "^16.0.10",
-    "react": "^19.2.3",
-    "react-dom": "^19.2.3",
+    "next": "^16.1.6",
+    "react": "^19.2.4",
+    "react-dom": "^19.2.4",
     "typescript": "^5.3.0",
     "@repo/typescript-config": "0.0.0"
   },
   "scripts": {
     "build": "tsc",
-    "check-types": "tsc --noEmit"
+    "check-types": "tsc --noEmit",
+    "lint": "biome lint ./src --fix",
+    "format": "biome format ./src --write"
   }
 }