next-typed-paths 0.1.0

package/README.md

@@ -0,0 +1,249 @@
+# Next Typed Routes
+
+Type-safe Next.js App Router route builder with automatic generation from your file system.
+
+## Features
+
+- 🔒 **Fully Type-Safe**: Get autocomplete and type checking for all your routes
+- 🔄 **Auto-Generated**: Scans your Next.js app directory and generates routes automatically
+- 👀 **Live Updates**: Watch mode regenerates routes when files change
+- ⚙️ **Configurable**: Support for config files and CLI options
+- 📦 **Zero Runtime Cost**: All types are compile-time only
+
+## Installation
+
+```bash
+npm install next-typed-paths
+```
+
+## Quick Start
+
+### 1. Generate Routes
+
+```bash
+npx next-typed-paths generate --input ./src/app/api --output ./src/generated/routes.ts
+```
+
+### 2. Use in Your Code
+
+```typescript
+import { routes } from "./generated/routes";
+
+// Type-safe route building
+const userRoute = routes.api.users.$userId("123"); // "/api/users/123"
+const listRoute = routes.api.users.$(); // "/api/users"
+```
+
+## Configuration
+
+Create a `routes.config.ts` file in your project root:
+
+```typescript
+import type { RouteConfig } from "next-typed-paths";
+
+const routeConfig: RouteConfig = {
+  input: "./src/app/api",
+  output: "./src/generated/routes.ts",
+  watch: false,
+  basePrefix: "/api",
+  paramTypes: {
+    userId: "string",
+    postId: "number",
+  },
+  imports: ["import { z } from 'zod';"],
+};
+
+export default routeConfig;
+```
+
+### Configuration Options
+
+- **`input`** (`string`, required): The directory path to scan for route files. This should point to your Next.js API routes directory (e.g., `./src/app/api` or `./src/app`). You can use next-typed-paths for just your REST API backend or also for any page routes that return UI.
+
+- **`output`** (`string`, required): The file path where the generated TypeScript routes file will be written. This file will contain all your type-safe route builders.
+
+- **`watch`** (`boolean`, optional): When set to `true`, the generator will run in watch mode and automatically regenerate routes whenever files change in the input directory. Defaults to `false`.
+
+- **`basePrefix`** (`string`, optional): A prefix that will be prepended to all generated routes. For example, if your API routes are under `/api`, set this to `"/api"` so generated routes include this prefix. Defaults to `""`.
+
+- **`paramTypes`** (`Record<string, string>`, optional): A mapping of parameter names to their TypeScript types. This allows you to specify custom types for dynamic route parameters instead of the default `string` type. For example, `{ userId: "number", postId: "string" }` will type the `userId` parameter as a number. Defaults to `{}`. You can even specify custom stricter types such as database table, user type, etc. Any unspecified route params will have their type defaulted to `string`.
+
+- **`imports`** (`string[]`, optional): An array of import statements to include at the top of the generated routes file. Useful if your route builders need to reference custom types or utilities. For example, `["import { z } from 'zod';", "import type { User } from './types';"]`. Defaults to `[]`.
+
+## CLI Commands
+
+### Generate Routes
+
+```bash
+npx next-typed-paths generate [options]
+```
+
+Options:
+
+- `-i, --input <path>`: Input directory to scan (default: "./app/api")
+- `-o, --output <path>`: Output file path (default: "./generated/routes.ts")
+- `-w, --watch`: Watch for changes and regenerate
+- `-c, --config <path>`: Path to config file
+
+### Watch Mode
+
+```bash
+npx next-typed-paths generate --watch
+```
+
+This will watch your app directory and automatically regenerate routes when files change.
+
+### Integration with Development Workflow
+
+You can integrate the route generator into your development workflow to automatically regenerate routes alongside your dev server. For example, if you are using [Nx](https://github.com/nrwl/nx), you can run both the Next.js dev server and the route generator in parallel:
+
+```json
+// project.json
+{
+  "name": "your-next-app",
+  "$schema": "../../node_modules/nx/schemas/project-schema.json",
+  "sourceRoot": "apps/your-next-app",
+  "projectType": "application",
+  "targets": {
+    "dev": {
+      "executor": "nx:run-commands",
+      "options": {
+        "commands": ["next dev", "npx next-typed-paths generate --watch"],
+        "parallel": true
+      }
+    },
+    "build": {
+      "executor": "@nx/next:build",
+      "outputs": ["{options.outputPath}"],
+      "options": {
+        "outputPath": "dist/apps/your-next-app"
+      }
+    }
+  }
+}
+```
+
+With `"parallel": true`, both commands run simultaneously:
+
+- `next dev` starts your Next.js development server
+- `npx next-typed-paths generate --watch` watches for route file changes and regenerates types
+
+This ensures your route types stay in sync with your file system as you develop.
+
+## How It Works
+
+The generator scans your Next.js app directory structure:
+
+```
+app/api/
+├── users/
+│   ├── route.ts              → routes.api.users.$()
+│   └── [userId]/
+│       └── route.ts          → routes.api.users.$userId(id)
+└── posts/
+    ├── route.ts              → routes.api.posts.$()
+    └── [postId]/
+        ├── route.ts          → routes.api.posts.$postId(id)
+        └── comments/
+            └── route.ts      → routes.api.posts.$postId(id).comments()
+```
+
+It uses the directory structure to generate in realtime a typed schema of the available routes in your Next.Js application. You are still responsible for ensuring you use the route in the correct way (i.e. correct HTTP method and query params), however, the route and path params are typed for you.
+
+## Examples
+
+### Basic Usage
+
+```typescript
+import { routes } from "./generated/routes";
+
+// Static routes
+routes.api.auth.login(); // "/api/auth/login"
+
+// Dynamic routes
+routes.api.users.$userId("123"); // "/api/users/123"
+
+// Nested dynamic routes
+routes.api.posts.$postId("456").comments(); // "/api/posts/456/comments"
+
+// Access parent route
+routes.api.users.$userId("123").$(); // "/api/users/123"
+```
+
+### With Next.js
+
+By no means are the following examples an indication you are pinned to using certain libraries (e.g. Axios, Tanstack Query). Rather I provide some examples within the context of some common patterns.
+
+#### In Client Components
+
+```typescript
+'use client';
+
+import { useState } from "react";
+
+import axios from "axios";
+
+import { User } from "@/common/types";
+import { routes } from '@/generated/routes';
+
+export const UsersList = () => {
+  const [users, setUsers] = useState<User[]>([]);
+
+  useEffect(() => {
+    // Type-safe API calls from the client
+    axios.get(routes.api.users.$())
+      .then(res => res.data)
+      .then(setUsers);
+  }, []);
+
+  return <div>{/* render users */}</div>;
+};
+```
+
+#### In Server Components
+
+```typescript
+const UserProfile = async ({ userId }: { userId: string }) => {
+  // Call your API with type-safe routes
+  const { data: user } = await axios.get(routes.api.users.$userId(userId));
+  return <div>{user.name}</div>;
+};
+```
+
+#### For redirects
+
+```typescript
+import { redirect } from "next/navigation";
+
+const handleLogin = (userId: string) => {
+  redirect(routes.api.auth.callback.$());
+};
+```
+
+#### Building URLs for links
+
+```typescript
+const UserLink = ({ userId }: { userId: string }) => {
+  return <a href={routes.api.users.$userId(userId)}>View Profile</a>;
+};
+```
+
+#### With [TanStack Query](https://github.com/TanStack/query)
+
+```typescript
+import { useQuery } from '@tanstack/react-query';
+
+const UserProfile = ({ userId }: { userId: string }) => {
+  const { data: user, isLoading } = useQuery({
+    queryKey: ['user', userId],
+    queryFn: () => axios.get(routes.api.users.$userId(userId)).then(res => res.data),
+  });
+
+  if (isLoading) return <div>Loading...</div>;
+  return <div>{user?.name}</div>;
+};
+```
+
+## License
+
+MIT

package/dist/cli.d.ts

@@ -0,0 +1,6 @@
+#!/usr/bin/env node
+/**
+ * CLI for Next.js route generation
+ */
+export {};
+//# sourceMappingURL=cli.d.ts.map

package/dist/cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";AAEA;;GAEG"}

package/dist/cli.js

@@ -0,0 +1,111 @@
+#!/usr/bin/env node
+/**
+ * CLI for Next.js route generation
+ */
+import { Command } from "commander";
+import { existsSync } from "fs";
+import { writeFile } from "fs/promises";
+import { dirname, join } from "path";
+import { loadConfig, mergeConfig } from "./config";
+import { CLI_NAME, CONFIG_FILE_NAME, DEFAULT_BASE_PREFIX, DEFAULT_INPUT_DIR, DEFAULT_OUTPUT_FILE, PACKAGE_NAME, PACKAGE_VERSION, } from "./constants";
+import { mkdirIfNotExists } from "./file";
+import { generateRouteFile } from "./generator";
+import { generateRouteStructure } from "./scanner";
+import { startWatcher } from "./watcher";
+const program = new Command();
+program
+    .name(CLI_NAME)
+    .description("Generate type-safe routes from Next.js app directory structure")
+    .version(PACKAGE_VERSION);
+/**
+ * Generate routes from directory structure
+ */
+const generateRoutes = async (config) => {
+    try {
+        console.log("🔍 Scanning directory:", config.input);
+        // Scan directory structure
+        const structure = await generateRouteStructure(config.input);
+        // Generate TypeScript code
+        const code = generateRouteFile(structure, config);
+        // Ensure output directory exists
+        const outputDir = dirname(config.output);
+        await mkdirIfNotExists(outputDir);
+        // Write output file
+        await writeFile(config.output, code, "utf-8");
+        console.log("✅ Routes generated successfully:");
+        console.log("   📁 Input:", config.input);
+        console.log("   📄 Output:", config.output);
+    }
+    catch (error) {
+        console.error("❌ Error generating routes:", error);
+        throw error;
+    }
+};
+/**
+ * Generate command
+ */
+program
+    .command("generate")
+    .description("Generate route file from Next.js app directory")
+    .option("-i, --input <path>", "Input directory to scan")
+    .option("-o, --output <path>", "Output file path")
+    .option("-w, --watch", "Watch for changes and regenerate")
+    .option("-c, --config <path>", "Path to config file")
+    .option("-p, --prefix <prefix>", "Base prefix for all routes")
+    .action(async (options) => {
+    try {
+        // Load base config from file
+        const baseConfig = await loadConfig(options.config);
+        // Merge with CLI options
+        const config = mergeConfig(baseConfig, {
+            input: options.input,
+            output: options.output,
+            watch: options.watch,
+            basePrefix: options.prefix,
+        });
+        // Generate initial routes
+        await generateRoutes(config);
+        // Start watch mode if requested
+        if (config.watch) {
+            startWatcher(config, async () => {
+                await generateRoutes(config);
+            });
+        }
+    }
+    catch (error) {
+        console.error(error);
+        process.exit(1);
+    }
+});
+/**
+ * Init command - create example config file
+ */
+program
+    .command("init")
+    .description("Create a routes.config.ts file with defaults")
+    .action(async () => {
+    const configContent = `import type { RouteConfig } from "${PACKAGE_NAME}";
+
+const config: RouteConfig = {
+  input: "${DEFAULT_INPUT_DIR}",
+  output: "${DEFAULT_OUTPUT_FILE}",
+  watch: false,
+  basePrefix: "${DEFAULT_BASE_PREFIX}",
+  paramTypes: {
+    // Add custom parameter types here
+    // Example: userId: 'string', postId: 'number'
+  },
+};
+
+export default config;
+`;
+    const configPath = join(process.cwd(), `${CONFIG_FILE_NAME}.ts`);
+    if (existsSync(configPath)) {
+        console.log(`⚠️  ${CONFIG_FILE_NAME}.ts already exists`);
+        return;
+    }
+    await writeFile(configPath, configContent, "utf-8");
+    console.log(`✅ Created ${CONFIG_FILE_NAME}.ts`);
+});
+program.parse();
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":"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"}

package/dist/config.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Configuration loader using cosmiconfig
+ */
+import { RouteConfig } from "./types";
+/**
+ * Default configuration
+ */
+export declare const defaultConfig: RouteConfig;
+/**
+ * Load configuration from file or use defaults
+ */
+export declare const loadConfig: (configPath?: string) => Promise<RouteConfig>;
+/**
+ * Merge config with CLI options
+ */
+export declare const mergeConfig: (baseConfig: RouteConfig, options: Partial<RouteConfig>) => RouteConfig;
+//# sourceMappingURL=config.d.ts.map

package/dist/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH,OAAO,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAKtC;;GAEG;AACH,eAAO,MAAM,aAAa,EAAE,WAM3B,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,UAAU,GAAU,aAAa,MAAM,KAAG,OAAO,CAAC,WAAW,CAgBzE,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,WAAW,GAAI,YAAY,WAAW,EAAE,SAAS,OAAO,CAAC,WAAW,CAAC,KAAG,WAKpF,CAAC"}

package/dist/config.js

@@ -0,0 +1,45 @@
+/**
+ * Configuration loader using cosmiconfig
+ */
+import { cosmiconfig } from "cosmiconfig";
+import { DEFAULT_INPUT_DIR, DEFAULT_OUTPUT_FILE, DEFAULT_BASE_PREFIX, CONFIG_MODULE_NAME } from "./constants";
+const explorer = cosmiconfig(CONFIG_MODULE_NAME);
+/**
+ * Default configuration
+ */
+export const defaultConfig = {
+    input: DEFAULT_INPUT_DIR,
+    output: DEFAULT_OUTPUT_FILE,
+    watch: false,
+    basePrefix: DEFAULT_BASE_PREFIX,
+    paramTypes: {},
+};
+/**
+ * Load configuration from file or use defaults
+ */
+export const loadConfig = async (configPath) => {
+    try {
+        const result = configPath ? await explorer.load(configPath) : await explorer.search();
+        if (result && result.config) {
+            return {
+                ...defaultConfig,
+                ...result.config,
+            };
+        }
+    }
+    catch (error) {
+        // Config file not found or invalid, use defaults
+        console.warn("No config file found, using defaults");
+    }
+    return defaultConfig;
+};
+/**
+ * Merge config with CLI options
+ */
+export const mergeConfig = (baseConfig, options) => {
+    return {
+        ...baseConfig,
+        ...Object.fromEntries(Object.entries(options).filter(([_, v]) => v !== undefined)),
+    };
+};
+//# sourceMappingURL=config.js.map

package/dist/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAG1C,OAAO,EAAE,iBAAiB,EAAE,mBAAmB,EAAE,mBAAmB,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AAE9G,MAAM,QAAQ,GAAG,WAAW,CAAC,kBAAkB,CAAC,CAAC;AAEjD;;GAEG;AACH,MAAM,CAAC,MAAM,aAAa,GAAgB;IACxC,KAAK,EAAE,iBAAiB;IACxB,MAAM,EAAE,mBAAmB;IAC3B,KAAK,EAAE,KAAK;IACZ,UAAU,EAAE,mBAAmB;IAC/B,UAAU,EAAE,EAAE;CACf,CAAC;AAEF;;GAEG;AACH,MAAM,CAAC,MAAM,UAAU,GAAG,KAAK,EAAE,UAAmB,EAAwB,EAAE;IAC5E,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,UAAU,CAAC,CAAC,CAAC,MAAM,QAAQ,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,MAAM,QAAQ,CAAC,MAAM,EAAE,CAAC;QAEtF,IAAI,MAAM,IAAI,MAAM,CAAC,MAAM,EAAE,CAAC;YAC5B,OAAO;gBACL,GAAG,aAAa;gBAChB,GAAG,MAAM,CAAC,MAAM;aACjB,CAAC;QACJ,CAAC;IACH,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,iDAAiD;QACjD,OAAO,CAAC,IAAI,CAAC,sCAAsC,CAAC,CAAC;IACvD,CAAC;IAED,OAAO,aAAa,CAAC;AACvB,CAAC,CAAC;AAEF;;GAEG;AACH,MAAM,CAAC,MAAM,WAAW,GAAG,CAAC,UAAuB,EAAE,OAA6B,EAAe,EAAE;IACjG,OAAO;QACL,GAAG,UAAU;QACb,GAAG,MAAM,CAAC,WAAW,CAAC,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,KAAK,SAAS,CAAC,CAAC;KACnF,CAAC;AACJ,CAAC,CAAC"}

package/dist/constants.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Constants used throughout the package
+ */
+export declare const PACKAGE_NAME = "next-typed-paths";
+export declare const PACKAGE_VERSION: any;
+export declare const CLI_NAME = "next-typed-paths";
+export declare const CONFIG_MODULE_NAME = "routes";
+export declare const CONFIG_FILE_NAME = "routes.config";
+export declare const DEFAULT_INPUT_DIR = "./app/api";
+export declare const DEFAULT_OUTPUT_FILE = "./generated/routes.ts";
+export declare const DEFAULT_BASE_PREFIX = "/api";
+export declare const WATCH_DEBOUNCE_MS = 300;
+export declare const ROUTE_FILE_EXTENSIONS: string[];
+export declare const ROUTE_FILE_NAME = "route";
+export declare const PAGE_FILE_NAME = "page";
+//# sourceMappingURL=constants.d.ts.map

package/dist/constants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../src/constants.ts"],"names":[],"mappings":"AAAA;;GAEG;AAUH,eAAO,MAAM,YAAY,qBAAqB,CAAC;AAC/C,eAAO,MAAM,eAAe,KAAiB,CAAC;AAC9C,eAAO,MAAM,QAAQ,qBAAe,CAAC;AACrC,eAAO,MAAM,kBAAkB,WAAW,CAAC;AAC3C,eAAO,MAAM,gBAAgB,kBAAkB,CAAC;AAEhD,eAAO,MAAM,iBAAiB,cAAc,CAAC;AAC7C,eAAO,MAAM,mBAAmB,0BAA0B,CAAC;AAC3D,eAAO,MAAM,mBAAmB,SAAS,CAAC;AAE1C,eAAO,MAAM,iBAAiB,MAAM,CAAC;AACrC,eAAO,MAAM,qBAAqB,UAAiC,CAAC;AACpE,eAAO,MAAM,eAAe,UAAU,CAAC;AACvC,eAAO,MAAM,cAAc,SAAS,CAAC"}

package/dist/constants.js

@@ -0,0 +1,22 @@
+/**
+ * Constants used throughout the package
+ */
+import { dirname, join } from "path";
+import { fileURLToPath } from "url";
+import { readFileSync } from "fs";
+const __dirname = dirname(fileURLToPath(import.meta.url));
+const packageJson = JSON.parse(readFileSync(join(__dirname, "../package.json"), "utf-8"));
+const packageVersion = packageJson.version;
+export const PACKAGE_NAME = "next-typed-paths";
+export const PACKAGE_VERSION = packageVersion;
+export const CLI_NAME = PACKAGE_NAME;
+export const CONFIG_MODULE_NAME = "routes";
+export const CONFIG_FILE_NAME = "routes.config";
+export const DEFAULT_INPUT_DIR = "./app/api";
+export const DEFAULT_OUTPUT_FILE = "./generated/routes.ts";
+export const DEFAULT_BASE_PREFIX = "/api";
+export const WATCH_DEBOUNCE_MS = 300;
+export const ROUTE_FILE_EXTENSIONS = [".ts", ".tsx", ".js", ".jsx"];
+export const ROUTE_FILE_NAME = "route";
+export const PAGE_FILE_NAME = "page";
+//# sourceMappingURL=constants.js.map

package/dist/constants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["../src/constants.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AACrC,OAAO,EAAE,aAAa,EAAE,MAAM,KAAK,CAAC;AACpC,OAAO,EAAE,YAAY,EAAE,MAAM,IAAI,CAAC;AAElC,MAAM,SAAS,GAAG,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;AAC1D,MAAM,WAAW,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,IAAI,CAAC,SAAS,EAAE,iBAAiB,CAAC,EAAE,OAAO,CAAC,CAAC,CAAC;AAC1F,MAAM,cAAc,GAAG,WAAW,CAAC,OAAO,CAAC;AAE3C,MAAM,CAAC,MAAM,YAAY,GAAG,kBAAkB,CAAC;AAC/C,MAAM,CAAC,MAAM,eAAe,GAAG,cAAc,CAAC;AAC9C,MAAM,CAAC,MAAM,QAAQ,GAAG,YAAY,CAAC;AACrC,MAAM,CAAC,MAAM,kBAAkB,GAAG,QAAQ,CAAC;AAC3C,MAAM,CAAC,MAAM,gBAAgB,GAAG,eAAe,CAAC;AAEhD,MAAM,CAAC,MAAM,iBAAiB,GAAG,WAAW,CAAC;AAC7C,MAAM,CAAC,MAAM,mBAAmB,GAAG,uBAAuB,CAAC;AAC3D,MAAM,CAAC,MAAM,mBAAmB,GAAG,MAAM,CAAC;AAE1C,MAAM,CAAC,MAAM,iBAAiB,GAAG,GAAG,CAAC;AACrC,MAAM,CAAC,MAAM,qBAAqB,GAAG,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,CAAC,CAAC;AACpE,MAAM,CAAC,MAAM,eAAe,GAAG,OAAO,CAAC;AACvC,MAAM,CAAC,MAAM,cAAc,GAAG,MAAM,CAAC"}

package/dist/file.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Make sure a directory exists, creating it if necessary
+ *
+ * @param dirPath - The path of the directory to ensure exists
+ */
+export declare const mkdirIfNotExists: (dirPath: string) => Promise<void>;
+//# sourceMappingURL=file.d.ts.map

package/dist/file.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"file.d.ts","sourceRoot":"","sources":["../src/file.ts"],"names":[],"mappings":"AAGA;;;;GAIG;AACH,eAAO,MAAM,gBAAgB,GAAU,SAAS,MAAM,KAAG,OAAO,CAAC,IAAI,CAIpE,CAAC"}

package/dist/file.js

@@ -0,0 +1,13 @@
+import { mkdir } from "fs/promises";
+import { existsSync } from "fs";
+/**
+ * Make sure a directory exists, creating it if necessary
+ *
+ * @param dirPath - The path of the directory to ensure exists
+ */
+export const mkdirIfNotExists = async (dirPath) => {
+    if (!existsSync(dirPath)) {
+        await mkdir(dirPath, { recursive: true });
+    }
+};
+//# sourceMappingURL=file.js.map

package/dist/file.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"file.js","sourceRoot":"","sources":["../src/file.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AACpC,OAAO,EAAE,UAAU,EAAE,MAAM,IAAI,CAAC;AAEhC;;;;GAIG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAG,KAAK,EAAE,OAAe,EAAiB,EAAE;IACvE,IAAI,CAAC,UAAU,CAAC,OAAO,CAAC,EAAE,CAAC;QACzB,MAAM,KAAK,CAAC,OAAO,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAC5C,CAAC;AACH,CAAC,CAAC"}

package/dist/generator.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Code generator for route files
+ */
+import { RouteNode, RouteConfig } from "./types";
+/**
+ * Generate complete route file content
+ */
+export declare const generateRouteFile: (structure: RouteNode, config: RouteConfig) => string;
+//# sourceMappingURL=generator.d.ts.map

package/dist/generator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"generator.d.ts","sourceRoot":"","sources":["../src/generator.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAkDjD;;GAEG;AACH,eAAO,MAAM,iBAAiB,GAAI,WAAW,SAAS,EAAE,QAAQ,WAAW,KAAG,MA8B7E,CAAC"}

package/dist/generator.js

@@ -0,0 +1,80 @@
+/**
+ * Code generator for route files
+ */
+import { PACKAGE_NAME } from "./constants";
+/**
+ * Generate TypeScript code for route structure constant
+ */
+const generateStructureCode = (structure, indent = 2) => {
+    const indentStr = " ".repeat(indent);
+    const lines = [];
+    // Sort entries to put $param and $route first
+    const entries = Object.entries(structure);
+    const metadataEntries = entries.filter(([key]) => key.startsWith("$"));
+    const regularEntries = entries.filter(([key]) => !key.startsWith("$"));
+    const sortedEntries = [...metadataEntries, ...regularEntries];
+    for (const [key, value] of sortedEntries) {
+        // Check if key needs to be quoted (contains special characters)
+        const needsQuotes = /[^a-zA-Z0-9_$]/.test(key);
+        const quotedKey = needsQuotes ? `"${key}"` : key;
+        if (typeof value === "object" && value !== null) {
+            const childLines = generateStructureCode(value, indent + 2);
+            if (childLines) {
+                lines.push(`${indentStr}${quotedKey}: {`);
+                lines.push(childLines);
+                lines.push(`${indentStr}},`);
+            }
+        }
+        else if (typeof value === "boolean") {
+            lines.push(`${indentStr}${quotedKey}: ${value},`);
+        }
+        else if (typeof value === "string") {
+            lines.push(`${indentStr}${quotedKey}: "${value}",`);
+        }
+    }
+    return lines.join("\n");
+};
+/**
+ * Generate parameter type map from config
+ */
+const generateParamTypeMap = (paramTypes) => {
+    if (!paramTypes || Object.keys(paramTypes).length === 0) {
+        return "{}";
+    }
+    const entries = Object.entries(paramTypes).map(([key, type]) => `  ${key}: ${type};`);
+    return `{\n${entries.join("\n")}\n}`;
+};
+/**
+ * Generate complete route file content
+ */
+export const generateRouteFile = (structure, config) => {
+    const structureCode = generateStructureCode(structure);
+    const paramTypeMap = generateParamTypeMap(config.paramTypes);
+    const basePrefix = config.basePrefix || "";
+    const customImports = config.imports?.join("\n") || "";
+    return `/**
+ * Auto-generated Next.js route builder
+ * Generated from: ${config.input}
+ * 
+ * DO NOT EDIT THIS FILE MANUALLY - it will be regenerated
+ */
+
+import { createRouteBuilder } from "${PACKAGE_NAME}/runtime";
+import type { RouteBuilderObject, GetParamType, HasChildren, RouteBuilder } from "${PACKAGE_NAME}/types";
+${customImports ? "\n" + customImports + "\n" : ""}
+// Route structure definition
+const ROUTE_STRUCTURE = {
+${structureCode}
+} as const;
+
+// Parameter type mappings
+type ParamTypeMap = ${paramTypeMap};
+
+// Type-safe route builder with parameter types
+export type Routes = RouteBuilderObject<typeof ROUTE_STRUCTURE, ParamTypeMap>;
+
+// Route builder instance
+export const routes = createRouteBuilder(ROUTE_STRUCTURE, [], "${basePrefix}") as Routes;
+`;
+};
+//# sourceMappingURL=generator.js.map

package/dist/generator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"generator.js","sourceRoot":"","sources":["../src/generator.ts"],"names":[],"mappings":"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"}

package/dist/index.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Main entry point for the package
+ */
+export { defaultConfig, loadConfig, mergeConfig } from "./config";
+export * from "./constants";
+export { generateRouteFile } from "./generator";
+export { buildRoutePath, createRouteBuilder } from "./runtime";
+export { generateRouteStructure, scanDirectory } from "./scanner";
+export type { GetParamType, HasChildren, RouteBuilder, RouteBuilderObject, RouteConfig, RouteNode } from "./types";
+export { startWatcher } from "./watcher";
+export type { RegenerateCallback } from "./watcher";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,aAAa,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AAClE,cAAc,aAAa,CAAC;AAC5B,OAAO,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAChD,OAAO,EAAE,cAAc,EAAE,kBAAkB,EAAE,MAAM,WAAW,CAAC;AAC/D,OAAO,EAAE,sBAAsB,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAClE,YAAY,EAAE,YAAY,EAAE,WAAW,EAAE,YAAY,EAAE,kBAAkB,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AACnH,OAAO,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AACzC,YAAY,EAAE,kBAAkB,EAAE,MAAM,WAAW,CAAC"}

package/dist/index.js

@@ -0,0 +1,10 @@
+/**
+ * Main entry point for the package
+ */
+export { defaultConfig, loadConfig, mergeConfig } from "./config";
+export * from "./constants";
+export { generateRouteFile } from "./generator";
+export { buildRoutePath, createRouteBuilder } from "./runtime";
+export { generateRouteStructure, scanDirectory } from "./scanner";
+export { startWatcher } from "./watcher";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,aAAa,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AAClE,cAAc,aAAa,CAAC;AAC5B,OAAO,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAChD,OAAO,EAAE,cAAc,EAAE,kBAAkB,EAAE,MAAM,WAAW,CAAC;AAC/D,OAAO,EAAE,sBAAsB,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAElE,OAAO,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC"}

package/dist/runtime.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Core route builder runtime
+ */
+/**
+ * Build a typed API route path from segments
+ */
+export declare const buildRoutePath: (segments: (string | number)[], basePrefix?: string) => string;
+/**
+ * Recursively build route builder functions from route structure
+ */
+export declare const createRouteBuilder: <T extends Record<string, any>>(structure: T, basePath?: (string | number)[], basePrefix?: string) => any;
+//# sourceMappingURL=runtime.d.ts.map

package/dist/runtime.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime.d.ts","sourceRoot":"","sources":["../src/runtime.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH;;GAEG;AACH,eAAO,MAAM,cAAc,GAAI,UAAU,CAAC,MAAM,GAAG,MAAM,CAAC,EAAE,EAAE,aAAY,MAAW,KAAG,MAGvF,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,kBAAkB,GAAI,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAC9D,WAAW,CAAC,EACZ,WAAU,CAAC,MAAM,GAAG,MAAM,CAAC,EAAO,EAClC,aAAY,MAAW,KACtB,GAuDF,CAAC"}

package/dist/runtime.js

@@ -0,0 +1,64 @@
+/**
+ * Core route builder runtime
+ */
+/**
+ * Build a typed API route path from segments
+ */
+export const buildRoutePath = (segments, basePrefix = "") => {
+    const path = segments.map((s) => String(s)).join("/");
+    return basePrefix ? `${basePrefix}/${path}` : `/${path}`;
+};
+/**
+ * Recursively build route builder functions from route structure
+ */
+export const createRouteBuilder = (structure, basePath = [], basePrefix = "") => {
+    const builder = {};
+    for (const [key, value] of Object.entries(structure)) {
+        // Skip metadata keys, but not route segment keys like $documentId
+        if (key === "$param" || key === "$route")
+            continue;
+        const currentPath = [...basePath, key];
+        if (typeof value === "object") {
+            const hasRoute = value.$route === true;
+            const hasParam = "$param" in value;
+            // Check if there are children (non-metadata keys)
+            const childKeys = Object.keys(value).filter((k) => k !== "$param" && k !== "$route");
+            const hasChildren = childKeys.length > 0;
+            if (hasParam) {
+                // This level has a parameter
+                builder[key] = (param) => {
+                    const paramPath = [...currentPath.slice(0, -1), param];
+                    if (hasChildren) {
+                        // Has children, build them with the parameter in the path
+                        const children = createRouteBuilder(value, paramPath, basePrefix);
+                        // If this level is also a route, add a $ method
+                        if (hasRoute) {
+                            Object.assign(children, { $: () => buildRoutePath(paramPath, basePrefix) });
+                        }
+                        return children;
+                    }
+                    else if (hasRoute) {
+                        // Leaf route with parameter
+                        return buildRoutePath(paramPath, basePrefix);
+                    }
+                    return buildRoutePath(paramPath, basePrefix);
+                };
+            }
+            else if (hasRoute && !hasChildren) {
+                // Leaf route with no children or params
+                builder[key] = () => buildRoutePath(currentPath, basePrefix);
+            }
+            else {
+                // Has children, recurse
+                const children = createRouteBuilder(value, currentPath, basePrefix);
+                if (hasRoute) {
+                    // Also a route itself
+                    Object.assign(children, { $: () => buildRoutePath(currentPath, basePrefix) });
+                }
+                builder[key] = children;
+            }
+        }
+    }
+    return builder;
+};
+//# sourceMappingURL=runtime.js.map

package/dist/runtime.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime.js","sourceRoot":"","sources":["../src/runtime.ts"],"names":[],"mappings":"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"}

package/dist/scanner.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Scanner for Next.js app directory structure
+ */
+import { RouteNode } from "./types";
+/**
+ * Recursively scan a directory and build route structure
+ */
+export declare const scanDirectory: (dirPath: string, basePath?: string) => Promise<RouteNode>;
+/**
+ * Scan Next.js app directory and generate route structure
+ */
+export declare const generateRouteStructure: (inputDir: string) => Promise<RouteNode>;
+//# sourceMappingURL=scanner.d.ts.map

package/dist/scanner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scanner.d.ts","sourceRoot":"","sources":["../src/scanner.ts"],"names":[],"mappings":"AAAA;;GAEG;AAOH,OAAO,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AAoCpC;;GAEG;AACH,eAAO,MAAM,aAAa,GAAU,SAAS,MAAM,EAAE,WAAU,MAAW,KAAG,OAAO,CAAC,SAAS,CAsC7F,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,sBAAsB,GAAU,UAAU,MAAM,KAAG,OAAO,CAAC,SAAS,CAGhF,CAAC"}

package/dist/scanner.js

@@ -0,0 +1,78 @@
+/**
+ * Scanner for Next.js app directory structure
+ */
+import { existsSync } from "fs";
+import { readdir } from "fs/promises";
+import { join, resolve } from "path";
+import { ROUTE_FILE_EXTENSIONS, ROUTE_FILE_NAME, PAGE_FILE_NAME } from "./constants";
+/**
+ * Check if a directory contains a route.ts or page.ts file
+ */
+const hasRouteFile = async (dirPath) => {
+    const fileNames = [ROUTE_FILE_NAME, PAGE_FILE_NAME];
+    const checks = await Promise.all(fileNames.flatMap((fileName) => ROUTE_FILE_EXTENSIONS.map(async (ext) => {
+        const filePath = join(dirPath, `${fileName}${ext}`);
+        return existsSync(filePath);
+    })));
+    return checks.some((exists) => exists);
+};
+/**
+ * Extract parameter name from Next.js dynamic segment [paramName]
+ */
+const extractParamName = (segment) => {
+    const match = segment.match(/^\[(.+)\]$/);
+    return match ? (match[1] ?? null) : null;
+};
+/**
+ * Convert parameter name from Next.js format to camelCase with $ prefix
+ * e.g., [userId] -> $userId, [user-id] -> $userId
+ */
+const formatParamName = (paramName) => {
+    // Convert kebab-case to camelCase
+    const camelCase = paramName.replace(/-([a-z])/g, (_, letter) => letter.toUpperCase());
+    return `$${camelCase}`;
+};
+/**
+ * Recursively scan a directory and build route structure
+ */
+export const scanDirectory = async (dirPath, basePath = "") => {
+    const node = {};
+    if (!existsSync(dirPath)) {
+        throw new Error(`Directory does not exist: ${dirPath}`);
+    }
+    // Check if this directory itself has a route
+    if (await hasRouteFile(dirPath)) {
+        node.$route = true;
+    }
+    // Read directory contents
+    const entries = await readdir(dirPath, { withFileTypes: true });
+    for (const entry of entries) {
+        // Skip non-directories and special directories
+        if (!entry.isDirectory() || entry.name.startsWith(".") || entry.name === "node_modules") {
+            continue;
+        }
+        const entryPath = join(dirPath, entry.name);
+        const paramName = extractParamName(entry.name);
+        if (paramName) {
+            // Dynamic segment [paramName]
+            const formattedName = formatParamName(paramName);
+            const childNode = await scanDirectory(entryPath, `${basePath}/${entry.name}`);
+            childNode.$param = paramName;
+            node[formattedName] = childNode;
+        }
+        else {
+            // Static segment
+            const childNode = await scanDirectory(entryPath, `${basePath}/${entry.name}`);
+            node[entry.name] = childNode;
+        }
+    }
+    return node;
+};
+/**
+ * Scan Next.js app directory and generate route structure
+ */
+export const generateRouteStructure = async (inputDir) => {
+    const resolvedPath = resolve(inputDir);
+    return scanDirectory(resolvedPath);
+};
+//# sourceMappingURL=scanner.js.map

package/dist/scanner.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"scanner.js","sourceRoot":"","sources":["../src/scanner.ts"],"names":[],"mappings":"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"}

package/dist/types.d.ts

@@ -0,0 +1,52 @@
+/**
+ * Type definitions for route builder
+ */
+export type HasChildren<T> = keyof Omit<T, "$param" | "$route"> extends never ? false : true;
+export type GetParamType<P extends string, TMap = {}> = P extends keyof TMap ? TMap[P] : string;
+export type RouteBuilder<T, TMap = {}> = T extends {
+    $param: infer P extends string;
+} ? HasChildren<T> extends true ? (param: GetParamType<P, TMap>) => RouteBuilderObject<Omit<T, "$param">, TMap> & (T extends {
+    $route: true;
+} ? {
+    $: () => string;
+} : {}) : T extends {
+    $route: true;
+} ? (param: GetParamType<P, TMap>) => string : (param: GetParamType<P, TMap>) => RouteBuilderObject<Omit<T, "$param">, TMap> : T extends {
+    $route: true;
+} ? () => string : T extends object ? RouteBuilderObject<T, TMap> : never;
+export type RouteBuilderObject<T, TMap = {}> = {
+    [K in keyof T as K extends "$param" | "$route" ? never : K]: RouteBuilder<T[K], TMap>;
+};
+/**
+ * Route structure node
+ */
+export interface RouteNode {
+    $param?: string;
+    $route?: boolean;
+    [key: string]: any;
+}
+/**
+ * Configuration options for route generation
+ */
+export interface RouteConfig {
+    /** Input directory to scan (e.g., "./app/api") */
+    input: string;
+    /** Output file path for generated routes */
+    output: string;
+    /** Watch for changes and regenerate */
+    watch?: boolean;
+    /** Base prefix for all routes (e.g., "/api") */
+    basePrefix?: string;
+    /**
+     * Parameter type mappings
+     * Allows for defining custom types for route parameters,
+     * which will be used in the generated route builder for
+     * type safety.
+     *
+     * Any parameter not defined here will default to string type.
+     */
+    paramTypes?: Record<string, string>;
+    /** Additional imports to include in generated file */
+    imports?: string[];
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,MAAM,MAAM,WAAW,CAAC,CAAC,IAAI,MAAM,IAAI,CAAC,CAAC,EAAE,QAAQ,GAAG,QAAQ,CAAC,SAAS,KAAK,GAAG,KAAK,GAAG,IAAI,CAAC;AAG7F,MAAM,MAAM,YAAY,CAAC,CAAC,SAAS,MAAM,EAAE,IAAI,GAAG,EAAE,IAAI,CAAC,SAAS,MAAM,IAAI,GAAG,IAAI,CAAC,CAAC,CAAC,GAAG,MAAM,CAAC;AAGhG,MAAM,MAAM,YAAY,CAAC,CAAC,EAAE,IAAI,GAAG,EAAE,IAAI,CAAC,SAAS;IAAE,MAAM,EAAE,MAAM,CAAC,SAAS,MAAM,CAAA;CAAE,GACjF,WAAW,CAAC,CAAC,CAAC,SAAS,IAAI,GACzB,CACE,KAAK,EAAE,YAAY,CAAC,CAAC,EAAE,IAAI,CAAC,KACzB,kBAAkB,CAAC,IAAI,CAAC,CAAC,EAAE,QAAQ,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,SAAS;IAAE,MAAM,EAAE,IAAI,CAAA;CAAE,GAAG;IAAE,CAAC,EAAE,MAAM,MAAM,CAAA;CAAE,GAAG,EAAE,CAAC,GAC1G,CAAC,SAAS;IAAE,MAAM,EAAE,IAAI,CAAA;CAAE,GACxB,CAAC,KAAK,EAAE,YAAY,CAAC,CAAC,EAAE,IAAI,CAAC,KAAK,MAAM,GACxC,CAAC,KAAK,EAAE,YAAY,CAAC,CAAC,EAAE,IAAI,CAAC,KAAK,kBAAkB,CAAC,IAAI,CAAC,CAAC,EAAE,QAAQ,CAAC,EAAE,IAAI,CAAC,GACjF,CAAC,SAAS;IAAE,MAAM,EAAE,IAAI,CAAA;CAAE,GACxB,MAAM,MAAM,GACZ,CAAC,SAAS,MAAM,GACd,kBAAkB,CAAC,CAAC,EAAE,IAAI,CAAC,GAC3B,KAAK,CAAC;AAEd,MAAM,MAAM,kBAAkB,CAAC,CAAC,EAAE,IAAI,GAAG,EAAE,IAAI;KAC5C,CAAC,IAAI,MAAM,CAAC,IAAI,CAAC,SAAS,QAAQ,GAAG,QAAQ,GAAG,KAAK,GAAG,CAAC,GAAG,YAAY,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,IAAI,CAAC;CACtF,CAAC;AAEF;;GAEG;AACH,MAAM,WAAW,SAAS;IACxB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,kDAAkD;IAClD,KAAK,EAAE,MAAM,CAAC;IACd,4CAA4C;IAC5C,MAAM,EAAE,MAAM,CAAC;IACf,uCAAuC;IACvC,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,gDAAgD;IAChD,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB;;;;;;;OAOG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACpC,sDAAsD;IACtD,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;CACpB"}

package/dist/types.js

@@ -0,0 +1,5 @@
+/**
+ * Type definitions for route builder
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;GAEG"}

package/dist/watcher.d.ts

@@ -0,0 +1,10 @@
+/**
+ * File watcher for live route regeneration
+ */
+import { RouteConfig } from "./types";
+export type RegenerateCallback = () => Promise<void>;
+/**
+ * Start watching the input directory for changes
+ */
+export declare const startWatcher: (config: RouteConfig, onRegenerate: RegenerateCallback) => void;
+//# sourceMappingURL=watcher.d.ts.map

package/dist/watcher.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"watcher.d.ts","sourceRoot":"","sources":["../src/watcher.ts"],"names":[],"mappings":"AAAA;;GAEG;AAMH,OAAO,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAEtC,MAAM,MAAM,kBAAkB,GAAG,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;AAErD;;GAEG;AACH,eAAO,MAAM,YAAY,GAAI,QAAQ,WAAW,EAAE,cAAc,kBAAkB,KAAG,IA6DpF,CAAC"}

package/dist/watcher.js

@@ -0,0 +1,66 @@
+/**
+ * File watcher for live route regeneration
+ */
+import { watch } from "chokidar";
+import { basename, relative, resolve } from "path";
+import { ROUTE_FILE_NAME, WATCH_DEBOUNCE_MS } from "./constants";
+/**
+ * Start watching the input directory for changes
+ */
+export const startWatcher = (config, onRegenerate) => {
+    const inputPath = resolve(config.input);
+    console.log(`👀 Watching for changes in: ${inputPath}`);
+    const watcher = watch(inputPath, {
+        ignored: /(^|[\/\\])\../, // ignore dotfiles
+        persistent: true,
+        ignoreInitial: true,
+    });
+    let regenerateTimer = null;
+    const scheduleRegenerate = () => {
+        // Debounce rapid changes
+        if (regenerateTimer) {
+            clearTimeout(regenerateTimer);
+        }
+        regenerateTimer = setTimeout(async () => {
+            console.log("\n🔄 Changes detected, regenerating routes...");
+            try {
+                await onRegenerate();
+                console.log("✅ Routes regenerated successfully");
+            }
+            catch (error) {
+                console.error("❌ Failed to regenerate routes:", error);
+            }
+        }, WATCH_DEBOUNCE_MS);
+    };
+    watcher
+        .on("add", (filePath) => {
+        if (basename(filePath).startsWith(`${ROUTE_FILE_NAME}.`)) {
+            console.log(`📝 New route file: ${relative(inputPath, filePath)}`);
+            scheduleRegenerate();
+        }
+    })
+        .on("unlink", (filePath) => {
+        if (basename(filePath).startsWith(`${ROUTE_FILE_NAME}.`)) {
+            console.log(`🗑️  Removed route file: ${relative(inputPath, filePath)}`);
+            scheduleRegenerate();
+        }
+    })
+        .on("addDir", (dirPath) => {
+        console.log(`📁 New directory: ${relative(inputPath, dirPath)}`);
+        scheduleRegenerate();
+    })
+        .on("unlinkDir", (dirPath) => {
+        console.log(`🗑️  Removed directory: ${relative(inputPath, dirPath)}`);
+        scheduleRegenerate();
+    })
+        .on("error", (error) => {
+        console.error("❌ Watcher error:", error);
+    });
+    // Handle graceful shutdown
+    process.on("SIGINT", () => {
+        console.log("\n👋 Stopping watcher...");
+        watcher.close();
+        process.exit(0);
+    });
+};
+//# sourceMappingURL=watcher.js.map

package/dist/watcher.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"watcher.js","sourceRoot":"","sources":["../src/watcher.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -0,0 +1,58 @@
+{
+  "name": "next-typed-paths",
+  "version": "0.1.0",
+  "description": "A realtime typesafe Next.Js route generation tool",
+  "keywords": [
+    "nextjs",
+    "routes",
+    "typescript",
+    "type-safe",
+    "app-router"
+  ],
+  "homepage": "https://github.com/hugs7/next-typed-paths#readme",
+  "bugs": {
+    "url": "https://github.com/hugs7/next-typed-paths/issues"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/hugs7/next-typed-paths.git"
+  },
+  "license": "MIT",
+  "author": "Hugo Burton",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "bin": {
+    "next-typed-paths": "./dist/cli.js"
+  },
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "prepublishOnly": "npm run build",
+    "test": "vitest"
+  },
+  "dependencies": {
+    "chokidar": "^5.0.0",
+    "commander": "^14.0.3",
+    "cosmiconfig": "^9.0.0",
+    "zod": "^4.3.6"
+  },
+  "devDependencies": {
+    "@types/node": "^25.2.1",
+    "typescript": "^5.9.3",
+    "vitest": "^4.0.18"
+  },
+  "peerDependencies": {
+    "typescript": ">=5.0.0"
+  }
+}