rari 0.3.2 → 0.4.0

package/dist/{app-routes-DIZ265rW.js → app-routes-DnV_PBQL.js}

@@ -9,13 +9,23 @@ const SPECIAL_FILES = {
 	ERROR: "error",
 	NOT_FOUND: "not-found",
 	TEMPLATE: "template",
-	DEFAULT: "default"
+	DEFAULT: "default",
+	ROUTE: "route"
 };
 const SEGMENT_PATTERNS = {
 	DYNAMIC: /^\[([^\]]+)\]$/,
 	CATCH_ALL: /^\[\.\.\.([^\]]+)\]$/,
 	OPTIONAL_CATCH_ALL: /^\[\[\.\.\.([^\]]+)\]\]$/
 };
+const HTTP_METHODS = [
+	"GET",
+	"POST",
+	"PUT",
+	"DELETE",
+	"PATCH",
+	"HEAD",
+	"OPTIONS"
+];
 var AppRouteGenerator = class {
 	appDir;
 	extensions;
@@ -37,12 +47,14 @@ var AppRouteGenerator = class {
 		const loading = [];
 		const errors = [];
 		const notFound = [];
-		await this.scanDirectory("", routes, layouts, loading, errors, notFound);
+		const apiRoutes = [];
+		await this.scanDirectory("", routes, layouts, loading, errors, notFound, apiRoutes);
 		if (this.verbose) {
 			console.warn(`[AppRouter] Found ${routes.length} routes`);
 			console.warn(`[AppRouter] Found ${layouts.length} layouts`);
 			console.warn(`[AppRouter] Found ${loading.length} loading components`);
 			console.warn(`[AppRouter] Found ${errors.length} error boundaries`);
+			console.warn(`[AppRouter] Found ${apiRoutes.length} API routes`);
 		}
 		return {
 			routes: this.sortRoutes(routes),
@@ -50,10 +62,11 @@ var AppRouteGenerator = class {
 			loading,
 			errors,
 			notFound,
+			apiRoutes: this.sortApiRoutes(apiRoutes),
 			generated: (/* @__PURE__ */ new Date()).toISOString()
 		};
 	}
-	async scanDirectory(relativePath, routes, layouts, loading, errors, notFound) {
+	async scanDirectory(relativePath, routes, layouts, loading, errors, notFound, apiRoutes) {
 		const fullPath = path.join(this.appDir, relativePath);
 		let entries;
 		try {
@@ -70,13 +83,13 @@ var AppRouteGenerator = class {
 				if (this.shouldScanDirectory(entry)) dirs.push(entry);
 			} else if (stat.isFile()) files.push(entry);
 		}
-		await this.processSpecialFiles(relativePath, files, routes, layouts, loading, errors, notFound);
+		await this.processSpecialFiles(relativePath, files, routes, layouts, loading, errors, notFound, apiRoutes);
 		for (const dir of dirs) {
 			const subPath = relativePath ? path.join(relativePath, dir) : dir;
-			await this.scanDirectory(subPath, routes, layouts, loading, errors, notFound);
+			await this.scanDirectory(subPath, routes, layouts, loading, errors, notFound, apiRoutes);
 		}
 	}
-	async processSpecialFiles(relativePath, files, routes, layouts, loading, errors, notFound) {
+	async processSpecialFiles(relativePath, files, routes, layouts, loading, errors, notFound, apiRoutes) {
 		const routePath = this.pathToRoute(relativePath);
 		const pageFile = this.findFile(files, SPECIAL_FILES.PAGE);
 		if (pageFile) {
@@ -114,6 +127,11 @@ var AppRouteGenerator = class {
 			path: routePath,
 			filePath: path.join(relativePath, notFoundFile)
 		});
+		const routeFile = this.findFile(files, SPECIAL_FILES.ROUTE);
+		if (routeFile) {
+			const apiRoute = await this.processApiRouteFile(relativePath, routeFile);
+			apiRoutes.push(apiRoute);
+		}
 	}
 	findFile(files, baseName) {
 		for (const ext of this.extensions) {
@@ -196,6 +214,16 @@ var AppRouteGenerator = class {
 			return a.path.localeCompare(b.path);
 		});
 	}
+	sortApiRoutes(routes) {
+		return routes.sort((a, b) => {
+			if (!a.isDynamic && b.isDynamic) return -1;
+			if (a.isDynamic && !b.isDynamic) return 1;
+			const aDepth = a.path.split("/").length;
+			const bDepth = b.path.split("/").length;
+			if (aDepth !== bDepth) return aDepth - bDepth;
+			return a.path.localeCompare(b.path);
+		});
+	}
 	sortLayouts(layouts) {
 		return layouts.sort((a, b) => {
 			if (a.path === "/" && b.path !== "/") return -1;
@@ -203,6 +231,32 @@ var AppRouteGenerator = class {
 			return a.path.split("/").length - b.path.split("/").length;
 		});
 	}
+	async detectHttpMethods(filePath) {
+		const fullPath = path.join(this.appDir, filePath);
+		const content = await promises.readFile(fullPath, "utf-8");
+		const methods = [];
+		for (const method of HTTP_METHODS) {
+			const functionExportRegex = /* @__PURE__ */ new RegExp(`export\\s+(?:async\\s+)?function\\s+${method}\\s*\\(`);
+			const constExportRegex = /* @__PURE__ */ new RegExp(`export\\s+(?:async\\s+)?(?:const|let|var)\\s+${method}\\s*=`);
+			if (functionExportRegex.test(content) || constExportRegex.test(content)) methods.push(method);
+		}
+		return methods;
+	}
+	async processApiRouteFile(relativePath, fileName) {
+		const filePath = path.join(relativePath, fileName);
+		const routePath = this.pathToRoute(relativePath);
+		const segments = this.parseRouteSegments(relativePath);
+		const params = this.extractParams(segments);
+		const methods = await this.detectHttpMethods(filePath);
+		return {
+			path: routePath,
+			filePath,
+			segments,
+			params,
+			isDynamic: params.length > 0,
+			methods
+		};
+	}
 };
 async function generateAppRouteManifest(appDir, options = {}) {
 	return new AppRouteGenerator({

package/dist/{app-routes-BvbStRcg.js → app-routes-cr6yLAYA.js}

@@ -1,3 +1,3 @@
-import { i as writeManifest, n as generateAppRouteManifest, r as loadManifest, t as AppRouteGenerator } from "./app-routes-DIZ265rW.js";
+import { i as writeManifest, n as generateAppRouteManifest, r as loadManifest, t as AppRouteGenerator } from "./app-routes-DnV_PBQL.js";
 
 export { AppRouteGenerator, generateAppRouteManifest, loadManifest, writeManifest };

package/dist/{app-types-DUzcpcTH.d.ts → app-types-BwXHrEWG.d.ts}

@@ -32,12 +32,21 @@ interface NotFoundEntry {
   path: string;
   filePath: string;
 }
+interface ApiRouteEntry {
+  path: string;
+  filePath: string;
+  segments: RouteSegment[];
+  params: string[];
+  isDynamic: boolean;
+  methods: string[];
+}
 interface AppRouteManifest {
   routes: AppRouteEntry[];
   layouts: LayoutEntry[];
   loading: LoadingEntry[];
   errors: ErrorEntry[];
   notFound: NotFoundEntry[];
+  apiRoutes: ApiRouteEntry[];
   generated: string;
 }
 interface RouteMetadata {
@@ -107,4 +116,4 @@ type ErrorComponent = (props: ErrorProps) => ReactNode;
 type LoadingComponent = (props?: LoadingProps) => ReactNode;
 type NotFoundComponent = (props?: NotFoundProps) => ReactNode;
 //#endregion
-export { RouteSegmentType as C, RouteSegment as S, NotFoundEntry as _, ErrorComponent as a, PageProps as b, GenerateMetadata as c, LayoutEntry as d, LayoutProps as f, NotFoundComponent as g, LoadingProps as h, AppRouterConfig as i, GenerateStaticParams as l, LoadingEntry as m, AppRouteManifest as n, ErrorEntry as o, LoadingComponent as p, AppRouteMatch as r, ErrorProps as s, AppRouteEntry as t, LayoutComponent as u, NotFoundProps as v, ServerPropsResult as w, RouteMetadata as x, PageComponent as y };
+export { RouteSegment as C, RouteMetadata as S, ServerPropsResult as T, NotFoundComponent as _, AppRouterConfig as a, PageComponent as b, ErrorProps as c, LayoutComponent as d, LayoutEntry as f, LoadingProps as g, LoadingEntry as h, AppRouteMatch as i, GenerateMetadata as l, LoadingComponent as m, AppRouteEntry as n, ErrorComponent as o, LayoutProps as p, AppRouteManifest as r, ErrorEntry as s, ApiRouteEntry as t, GenerateStaticParams as u, NotFoundEntry as v, RouteSegmentType as w, PageProps as x, NotFoundProps as y };

package/dist/client.d.ts

@@ -1,3 +1,3 @@
-import { C as RouteSegmentType, S as RouteSegment, _ as NotFoundEntry, b as PageProps, c as GenerateMetadata, d as LayoutEntry, f as LayoutProps, h as LoadingProps, l as GenerateStaticParams, m as LoadingEntry, n as AppRouteManifest, o as ErrorEntry, r as AppRouteMatch, s as ErrorProps, t as AppRouteEntry, v as NotFoundProps } from "./app-types-DUzcpcTH.js";
+import { C as RouteSegment, c as ErrorProps, f as LayoutEntry, g as LoadingProps, h as LoadingEntry, i as AppRouteMatch, l as GenerateMetadata, n as AppRouteEntry, p as LayoutProps, r as AppRouteManifest, s as ErrorEntry, u as GenerateStaticParams, v as NotFoundEntry, w as RouteSegmentType, x as PageProps, y as NotFoundProps } from "./app-types-BwXHrEWG.js";
 import { _ as extractServerProps, a as LoadingSpinner, b as hasServerSideDataFetching, c as createErrorBoundary, d as MetadataResult, f as ServerPropsResult, g as extractMetadata, h as clearPropsCacheForComponent, i as HttpRuntimeClient, l as createHttpRuntimeClient, m as clearPropsCache, n as DefaultLoading, o as NotFound, p as StaticParamsResult, r as ErrorBoundary, s as RuntimeClient, t as DefaultError, u as createLoadingBoundary, v as extractServerPropsWithCache, y as extractStaticParams } from "./runtime-client-DXTHjUDN.js";
 export { type AppRouteEntry, type AppRouteManifest, type AppRouteMatch, DefaultError, DefaultLoading, ErrorBoundary, type ErrorEntry, type ErrorProps, type GenerateMetadata, type GenerateStaticParams, HttpRuntimeClient, type LayoutEntry, type LayoutProps, type LoadingEntry, type LoadingProps, LoadingSpinner, type MetadataResult, NotFound, type NotFoundEntry, type NotFoundProps, type PageProps, type RouteSegment, type RouteSegmentType, type RuntimeClient, type ServerPropsResult, type StaticParamsResult, clearPropsCache, clearPropsCacheForComponent, createErrorBoundary, createHttpRuntimeClient, createLoadingBoundary, extractMetadata, extractServerProps, extractServerPropsWithCache, extractStaticParams, hasServerSideDataFetching };

package/dist/index.d.ts

@@ -1,5 +1,5 @@
-import { C as RouteSegmentType, S as RouteSegment, _ as NotFoundEntry, a as ErrorComponent, b as PageProps, c as GenerateMetadata, d as LayoutEntry, f as LayoutProps, g as NotFoundComponent, h as LoadingProps, i as AppRouterConfig, l as GenerateStaticParams, m as LoadingEntry, n as AppRouteManifest, o as ErrorEntry, p as LoadingComponent, r as AppRouteMatch, s as ErrorProps, t as AppRouteEntry, u as LayoutComponent, v as NotFoundProps, w as ServerPropsResult, x as RouteMetadata, y as PageComponent } from "./app-types-DUzcpcTH.js";
+import { C as RouteSegment, S as RouteMetadata, T as ServerPropsResult, _ as NotFoundComponent, a as AppRouterConfig, b as PageComponent, c as ErrorProps, d as LayoutComponent, f as LayoutEntry, g as LoadingProps, h as LoadingEntry, i as AppRouteMatch, l as GenerateMetadata, m as LoadingComponent, n as AppRouteEntry, o as ErrorComponent, p as LayoutProps, r as AppRouteManifest, s as ErrorEntry, t as ApiRouteEntry, u as GenerateStaticParams, v as NotFoundEntry, w as RouteSegmentType, x as PageProps, y as NotFoundProps } from "./app-types-BwXHrEWG.js";
 import { a as useOptimisticAction, i as useActionStateWithFallback, n as ActionState, o as useValidatedAction, r as useActionState, t as ActionFunction } from "./useActionState-5zFMIoLK.js";
 import { a as createServerReference, i as createFormAction, n as ServerActionResponse, o as enhanceFormWithAction, r as bindServerActions, t as ServerActionOptions } from "./actions-Ctw8vS6Y.js";
 import { n as defineRariOptions, r as rari, t as defineRariConfig } from "./index-BlvegZl_.js";
-export { ActionFunction, ActionState, AppRouteEntry, AppRouteManifest, AppRouteMatch, AppRouterConfig, ErrorComponent, ErrorEntry, ErrorProps, GenerateMetadata, GenerateStaticParams, LayoutComponent, LayoutEntry, LayoutProps, LoadingComponent, LoadingEntry, LoadingProps, NotFoundComponent, NotFoundEntry, NotFoundProps, PageComponent, PageProps, RouteMetadata, RouteSegment, RouteSegmentType, ServerActionOptions, ServerActionResponse, ServerPropsResult, bindServerActions, createFormAction, createServerReference, defineRariConfig, defineRariOptions, enhanceFormWithAction, rari, useActionState, useActionStateWithFallback, useOptimisticAction, useValidatedAction };
+export { ActionFunction, ActionState, ApiRouteEntry, AppRouteEntry, AppRouteManifest, AppRouteMatch, AppRouterConfig, ErrorComponent, ErrorEntry, ErrorProps, GenerateMetadata, GenerateStaticParams, LayoutComponent, LayoutEntry, LayoutProps, LoadingComponent, LoadingEntry, LoadingProps, NotFoundComponent, NotFoundEntry, NotFoundProps, PageComponent, PageProps, RouteMetadata, RouteSegment, RouteSegmentType, ServerActionOptions, ServerActionResponse, ServerPropsResult, bindServerActions, createFormAction, createServerReference, defineRariConfig, defineRariOptions, enhanceFormWithAction, rari, useActionState, useActionStateWithFallback, useOptimisticAction, useValidatedAction };

package/dist/index.js

@@ -1,6 +1,6 @@
 import { i as useValidatedAction, n as useActionStateWithFallback, r as useOptimisticAction, t as useActionState } from "./useActionState-AoBy7bZm.js";
 import { i as enhanceFormWithAction, n as createFormAction, r as createServerReference, t as bindServerActions } from "./actions-5ADnvImc.js";
-import { n as defineRariOptions, r as rari, t as defineRariConfig } from "./vite-BzuW6jU8.js";
+import { n as defineRariOptions, r as rari, t as defineRariConfig } from "./vite-C3iz9pDD.js";
 import "./server-build-LuVSR-Im.js";
 
 export { bindServerActions, createFormAction, createServerReference, defineRariConfig, defineRariOptions, enhanceFormWithAction, rari, useActionState, useActionStateWithFallback, useOptimisticAction, useValidatedAction };

package/dist/server.d.ts

@@ -1,4 +1,4 @@
-import { C as RouteSegmentType, S as RouteSegment, _ as NotFoundEntry, b as PageProps, c as GenerateMetadata, d as LayoutEntry, f as LayoutProps, h as LoadingProps, l as GenerateStaticParams, m as LoadingEntry, n as AppRouteManifest, o as ErrorEntry, r as AppRouteMatch, s as ErrorProps, t as AppRouteEntry, v as NotFoundProps } from "./app-types-DUzcpcTH.js";
+import { C as RouteSegment, c as ErrorProps, f as LayoutEntry, g as LoadingProps, h as LoadingEntry, i as AppRouteMatch, l as GenerateMetadata, n as AppRouteEntry, p as LayoutProps, r as AppRouteManifest, s as ErrorEntry, u as GenerateStaticParams, v as NotFoundEntry, w as RouteSegmentType, x as PageProps, y as NotFoundProps } from "./app-types-BwXHrEWG.js";
 import { _ as extractServerProps, b as hasServerSideDataFetching, d as MetadataResult, f as ServerPropsResult, g as extractMetadata, h as clearPropsCacheForComponent, i as HttpRuntimeClient, l as createHttpRuntimeClient, m as clearPropsCache, p as StaticParamsResult, s as RuntimeClient, v as extractServerPropsWithCache, y as extractStaticParams } from "./runtime-client-DXTHjUDN.js";
 import { n as defineRariOptions, r as rari, t as defineRariConfig } from "./index-BlvegZl_.js";
 import { Plugin } from "rolldown-vite";
@@ -25,7 +25,10 @@ declare class AppRouteGenerator {
   findLayoutChain(routePath: string, manifest: AppRouteManifest): Promise<LayoutEntry[]>;
   private shouldScanDirectory;
   private sortRoutes;
+  private sortApiRoutes;
   private sortLayouts;
+  private detectHttpMethods;
+  private processApiRouteFile;
 }
 declare function generateAppRouteManifest(appDir: string, options?: Partial<AppRouteGeneratorOptions>): Promise<AppRouteManifest>;
 declare function writeManifest(manifest: AppRouteManifest, outputPath: string): Promise<void>;
@@ -39,7 +42,31 @@ interface RariRouterPluginOptions {
 }
 declare function rariRouter(options?: RariRouterPluginOptions): Plugin;
 //#endregion
+//#region src/api-routes.d.ts
+interface RouteContext<TParams extends Record<string, string> = Record<string, string>> {
+  params: TParams;
+}
+type RouteHandler<TParams extends Record<string, string> = Record<string, string>> = (request: Request, context?: RouteContext<TParams>) => Response | Promise<Response> | any | Promise<any>;
+interface ApiRouteHandlers<TParams extends Record<string, string> = Record<string, string>> {
+  GET?: RouteHandler<TParams>;
+  POST?: RouteHandler<TParams>;
+  PUT?: RouteHandler<TParams>;
+  DELETE?: RouteHandler<TParams>;
+  PATCH?: RouteHandler<TParams>;
+  HEAD?: RouteHandler<TParams>;
+  OPTIONS?: RouteHandler<TParams>;
+}
+declare class RariResponse extends Response {
+  static json(data: any, init?: ResponseInit): Response;
+  static redirect(url: string, status?: number): Response;
+  static noContent(init?: ResponseInit): Response;
+}
+//#endregion
 //#region src/async-context.d.ts
 declare function headers(): Promise<Headers>;
 //#endregion
-export { type AppRouteEntry, AppRouteGenerator, type AppRouteManifest, type AppRouteMatch, type ErrorEntry, type ErrorProps, type GenerateMetadata, type GenerateStaticParams, HttpRuntimeClient, type LayoutEntry, type LayoutProps, type LoadingEntry, type LoadingProps, type MetadataResult, type NotFoundEntry, type NotFoundProps, type PageProps, type RouteSegment, type RouteSegmentType, type RuntimeClient, type ServerPropsResult, type StaticParamsResult, clearPropsCache, clearPropsCacheForComponent, createHttpRuntimeClient, defineRariConfig, defineRariOptions, extractMetadata, extractServerProps, extractServerPropsWithCache, extractStaticParams, generateAppRouteManifest, hasServerSideDataFetching, headers, loadManifest, rari, rariRouter, writeManifest };
+//#region src/server.d.ts
+type Request$1 = globalThis.Request;
+type Response$1 = globalThis.Response;
+//#endregion
+export { type ApiRouteHandlers, type AppRouteEntry, AppRouteGenerator, type AppRouteManifest, type AppRouteMatch, type ErrorEntry, type ErrorProps, type GenerateMetadata, type GenerateStaticParams, HttpRuntimeClient, type LayoutEntry, type LayoutProps, type LoadingEntry, type LoadingProps, type MetadataResult, type NotFoundEntry, type NotFoundProps, type PageProps, RariResponse, Request$1 as Request, Response$1 as Response, type RouteContext, type RouteHandler, type RouteSegment, type RouteSegmentType, type RuntimeClient, type ServerPropsResult, type StaticParamsResult, clearPropsCache, clearPropsCacheForComponent, createHttpRuntimeClient, defineRariConfig, defineRariOptions, extractMetadata, extractServerProps, extractServerPropsWithCache, extractStaticParams, generateAppRouteManifest, hasServerSideDataFetching, headers, loadManifest, rari, rariRouter, writeManifest };

package/dist/server.js

@@ -1,6 +1,6 @@
-import { n as defineRariOptions, r as rari, t as defineRariConfig } from "./vite-BzuW6jU8.js";
+import { n as defineRariOptions, r as rari, t as defineRariConfig } from "./vite-C3iz9pDD.js";
 import "./server-build-LuVSR-Im.js";
-import { i as writeManifest, n as generateAppRouteManifest, r as loadManifest, t as AppRouteGenerator } from "./app-routes-DIZ265rW.js";
+import { i as writeManifest, n as generateAppRouteManifest, r as loadManifest, t as AppRouteGenerator } from "./app-routes-DnV_PBQL.js";
 import { c as createHttpRuntimeClient, d as clearPropsCacheForComponent, f as extractMetadata, g as hasServerSideDataFetching, h as extractStaticParams, i as HttpRuntimeClient, m as extractServerPropsWithCache, p as extractServerProps, u as clearPropsCache } from "./runtime-client-0_G-RIhY.js";
 import { promises } from "node:fs";
 import path, { join, relative, resolve, sep } from "node:path";
@@ -1577,6 +1577,7 @@ function getAppRouterFileType(filePath) {
 		case "loading": return "loading";
 		case "error": return "error";
 		case "not-found": return "not-found";
+		case "route": return "route";
 		default: return null;
 	}
 }
@@ -1622,6 +1623,41 @@ function extractMetadata$1(fileContent) {
 		return null;
 	}
 }
+function detectHttpMethods(fileContent) {
+	const methods = [];
+	for (const method of [
+		"GET",
+		"POST",
+		"PUT",
+		"DELETE",
+		"PATCH",
+		"HEAD",
+		"OPTIONS"
+	]) {
+		const functionExportRegex = /* @__PURE__ */ new RegExp(`export\\s+(?:async\\s+)?function\\s+${method}\\s*\\(`);
+		const constExportRegex = /* @__PURE__ */ new RegExp(`export\\s+(?:async\\s+)?(?:const|let|var)\\s+${method}\\s*=`);
+		if (functionExportRegex.test(fileContent) || constExportRegex.test(fileContent)) methods.push(method);
+	}
+	return methods;
+}
+async function notifyApiRouteInvalidation(filePath) {
+	try {
+		const response = await fetch("http://localhost:3000/api/rsc/hmr-invalidate-api-route", {
+			method: "POST",
+			headers: { "Content-Type": "application/json" },
+			body: JSON.stringify({ filePath })
+		});
+		if (!response.ok) {
+			console.error(`Failed to invalidate API route cache: ${response.statusText}`);
+			return;
+		}
+		const result = await response.json();
+		if (result.success) console.warn(`[HMR] API route handler cache invalidated: ${filePath}`);
+		else console.error(`[HMR] Failed to invalidate API route cache: ${result.error || "Unknown error"}`);
+	} catch (error) {
+		console.error("Failed to notify API route invalidation:", error);
+	}
+}
 function rariRouter(options = {}) {
 	const opts = {
 		...DEFAULT_OPTIONS,
@@ -1668,7 +1704,7 @@ function rariRouter(options = {}) {
 				console.warn("[Manifest] Route structure unchanged, using cached manifest");
 				return cachedManifestContent;
 			}
-			const { generateAppRouteManifest: generateAppRouteManifest$1 } = await import("./app-routes-BvbStRcg.js");
+			const { generateAppRouteManifest: generateAppRouteManifest$1 } = await import("./app-routes-cr6yLAYA.js");
 			const manifest = await generateAppRouteManifest$1(appDir, { extensions: opts.extensions });
 			const manifestContent = JSON.stringify(manifest, null, 2);
 			const outDir = path.resolve(root, opts.outDir);
@@ -1742,6 +1778,7 @@ function rariRouter(options = {}) {
 						const affectedRoutes = getAffectedRoutes(routePath, fileType, allRoutes);
 						let metadata;
 						let metadataChanged = false;
+						let methods;
 						if (fileType === "page" || fileType === "layout") try {
 							const extractedMetadata = extractMetadata$1(await promises.readFile(file, "utf-8"));
 							if (extractedMetadata) {
@@ -1752,6 +1789,13 @@ function rariRouter(options = {}) {
 						} catch (error) {
 							console.error("Failed to extract metadata:", error);
 						}
+						if (fileType === "route") try {
+							methods = detectHttpMethods(await promises.readFile(file, "utf-8"));
+							console.warn(`[HMR] API route methods detected: ${methods.join(", ")}`);
+							await notifyApiRouteInvalidation(path.relative(appDir, file));
+						} catch (error) {
+							console.error("Failed to detect HTTP methods:", error);
+						}
 						const hmrData = {
 							fileType,
 							filePath: path.relative(server$1.config.root, file),
@@ -1760,7 +1804,8 @@ function rariRouter(options = {}) {
 							manifestUpdated,
 							timestamp: Date.now(),
 							metadata,
-							metadataChanged
+							metadataChanged,
+							methods
 						};
 						server$1.ws.send({
 							type: "custom",
@@ -1768,7 +1813,8 @@ function rariRouter(options = {}) {
 							data: hmrData
 						});
 						const metadataInfo = metadataChanged ? " [metadata updated]" : "";
-						console.warn(`[HMR] App router ${fileType} changed: ${hmrData.filePath} (affects ${affectedRoutes.length} route${affectedRoutes.length === 1 ? "" : "s"})${metadataInfo}`);
+						const methodsInfo = methods ? ` [methods: ${methods.join(", ")}]` : "";
+						console.warn(`[HMR] App router ${fileType} changed: ${hmrData.filePath} (affects ${affectedRoutes.length} route${affectedRoutes.length === 1 ? "" : "s"})${metadataInfo}${methodsInfo}`);
 					}, DEBOUNCE_DELAY);
 					pendingHMRUpdates.set(file, timer);
 					return [];
@@ -1794,6 +1840,31 @@ function rariRouter(options = {}) {
 	};
 }
 
+//#endregion
+//#region src/api-routes.ts
+var RariResponse = class extends Response {
+	static json(data, init) {
+		const headers$1 = new Headers(init?.headers);
+		if (!headers$1.has("content-type")) headers$1.set("content-type", "application/json");
+		return new Response(JSON.stringify(data), {
+			...init,
+			headers: headers$1
+		});
+	}
+	static redirect(url, status = 307) {
+		return new Response(null, {
+			status,
+			headers: { location: url }
+		});
+	}
+	static noContent(init) {
+		return new Response(null, {
+			...init,
+			status: 204
+		});
+	}
+};
+
 //#endregion
 //#region src/async-context.ts
 let currentContext = null;
@@ -1810,4 +1881,4 @@ async function headers() {
 }
 
 //#endregion
-export { AppRouteGenerator, HttpRuntimeClient, clearPropsCache, clearPropsCacheForComponent, createHttpRuntimeClient, defineRariConfig, defineRariOptions, extractMetadata, extractServerProps, extractServerPropsWithCache, extractStaticParams, generateAppRouteManifest, hasServerSideDataFetching, headers, loadManifest, rari, rariRouter, writeManifest };
+export { AppRouteGenerator, HttpRuntimeClient, RariResponse, clearPropsCache, clearPropsCacheForComponent, createHttpRuntimeClient, defineRariConfig, defineRariOptions, extractMetadata, extractServerProps, extractServerPropsWithCache, extractStaticParams, generateAppRouteManifest, hasServerSideDataFetching, headers, loadManifest, rari, rariRouter, writeManifest };

package/dist/{vite-BzuW6jU8.js → vite-C3iz9pDD.js}

@@ -1065,8 +1065,13 @@ export async function renderApp() {
     );
     ` : "const wrappedContent = contentToRender;"}
 
-    const root = createRoot(rootElement);
-    root.render(wrappedContent);
+    if (hasSSRContent) {
+      hydrateRoot(rootElement, wrappedContent);
+      isInitialHydration = false;
+    } else {
+      const root = createRoot(rootElement);
+      root.render(wrappedContent);
+    }
   } catch (error) {
     console.error('[Rari] Error rendering app:', error);
     rootElement.innerHTML = \`

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "rari",
   "type": "module",
-  "version": "0.3.2",
+  "version": "0.4.0",
   "description": "Runtime Accelerated Rendering Infrastructure (Rari)",
   "author": "Ryan Skinner",
   "license": "MIT",
@@ -89,20 +89,20 @@
     "picocolors": "^1.1.1"
   },
   "optionalDependencies": {
-    "rari-darwin-arm64": "0.3.2",
-    "rari-darwin-x64": "0.3.2",
-    "rari-linux-arm64": "0.3.2",
-    "rari-linux-x64": "0.3.2",
-    "rari-win32-x64": "0.3.2"
+    "rari-darwin-arm64": "0.4.0",
+    "rari-darwin-x64": "0.4.0",
+    "rari-linux-arm64": "0.4.0",
+    "rari-linux-x64": "0.4.0",
+    "rari-win32-x64": "0.4.0"
   },
   "devDependencies": {
-    "@types/node": "^24.9.1",
+    "@types/node": "^24.9.2",
     "@types/react": "^19.2.2",
     "@typescript/native-preview": "7.0.0-dev.20250923.1",
     "chokidar": "^4.0.3",
     "eslint": "^9.38.0",
-    "oxlint": "^1.23.0",
-    "rolldown-vite": "^7.1.19",
-    "tsdown": "^0.15.9"
+    "oxlint": "^1.25.0",
+    "rolldown-vite": "^7.1.20",
+    "tsdown": "^0.15.12"
   }
 }

package/src/api-routes.ts

@@ -0,0 +1,49 @@
+export interface RouteContext<TParams extends Record<string, string> = Record<string, string>> {
+  params: TParams
+}
+
+export type RouteHandler<TParams extends Record<string, string> = Record<string, string>> = (
+  request: Request,
+  context?: RouteContext<TParams>,
+) => Response | Promise<Response> | any | Promise<any>
+
+export interface ApiRouteHandlers<TParams extends Record<string, string> = Record<string, string>> {
+  GET?: RouteHandler<TParams>
+  POST?: RouteHandler<TParams>
+  PUT?: RouteHandler<TParams>
+  DELETE?: RouteHandler<TParams>
+  PATCH?: RouteHandler<TParams>
+  HEAD?: RouteHandler<TParams>
+  OPTIONS?: RouteHandler<TParams>
+}
+
+export class RariResponse extends Response {
+  static json(data: any, init?: ResponseInit): Response {
+    const headers = new Headers(init?.headers)
+
+    if (!headers.has('content-type')) {
+      headers.set('content-type', 'application/json')
+    }
+
+    return new Response(JSON.stringify(data), {
+      ...init,
+      headers,
+    })
+  }
+
+  static redirect(url: string, status: number = 307): Response {
+    return new Response(null, {
+      status,
+      headers: {
+        location: url,
+      },
+    })
+  }
+
+  static noContent(init?: ResponseInit): Response {
+    return new Response(null, {
+      ...init,
+      status: 204,
+    })
+  }
+}

package/src/router/app-routes.ts

@@ -1,4 +1,5 @@
 import type {
+  ApiRouteEntry,
   AppRouteEntry,
   AppRouteManifest,
   ErrorEntry,
@@ -25,6 +26,7 @@ const SPECIAL_FILES = {
   NOT_FOUND: 'not-found',
   TEMPLATE: 'template',
   DEFAULT: 'default',
+  ROUTE: 'route',
 } as const
 
 const SEGMENT_PATTERNS = {
@@ -33,6 +35,8 @@ const SEGMENT_PATTERNS = {
   OPTIONAL_CATCH_ALL: /^\[\[\.\.\.([^\]]+)\]\]$/,
 } as const
 
+const HTTP_METHODS = ['GET', 'POST', 'PUT', 'DELETE', 'PATCH', 'HEAD', 'OPTIONS'] as const
+
 export class AppRouteGenerator {
   private appDir: string
   private extensions: string[]
@@ -54,14 +58,16 @@ export class AppRouteGenerator {
     const loading: LoadingEntry[] = []
     const errors: ErrorEntry[] = []
     const notFound: NotFoundEntry[] = []
+    const apiRoutes: ApiRouteEntry[] = []
 
-    await this.scanDirectory('', routes, layouts, loading, errors, notFound)
+    await this.scanDirectory('', routes, layouts, loading, errors, notFound, apiRoutes)
 
     if (this.verbose) {
       console.warn(`[AppRouter] Found ${routes.length} routes`)
       console.warn(`[AppRouter] Found ${layouts.length} layouts`)
       console.warn(`[AppRouter] Found ${loading.length} loading components`)
       console.warn(`[AppRouter] Found ${errors.length} error boundaries`)
+      console.warn(`[AppRouter] Found ${apiRoutes.length} API routes`)
     }
 
     return {
@@ -70,6 +76,7 @@ export class AppRouteGenerator {
       loading,
       errors,
       notFound,
+      apiRoutes: this.sortApiRoutes(apiRoutes),
       generated: new Date().toISOString(),
     }
   }
@@ -81,6 +88,7 @@ export class AppRouteGenerator {
     loading: LoadingEntry[],
     errors: ErrorEntry[],
     notFound: NotFoundEntry[],
+    apiRoutes: ApiRouteEntry[],
   ): Promise<void> {
     const fullPath = path.join(this.appDir, relativePath)
 
@@ -117,11 +125,12 @@ export class AppRouteGenerator {
       loading,
       errors,
       notFound,
+      apiRoutes,
     )
 
     for (const dir of dirs) {
       const subPath = relativePath ? path.join(relativePath, dir) : dir
-      await this.scanDirectory(subPath, routes, layouts, loading, errors, notFound)
+      await this.scanDirectory(subPath, routes, layouts, loading, errors, notFound, apiRoutes)
     }
   }
 
@@ -133,6 +142,7 @@ export class AppRouteGenerator {
     loading: LoadingEntry[],
     errors: ErrorEntry[],
     notFound: NotFoundEntry[],
+    apiRoutes: ApiRouteEntry[],
   ): Promise<void> {
     const routePath = this.pathToRoute(relativePath)
 
@@ -183,6 +193,12 @@ export class AppRouteGenerator {
         filePath: path.join(relativePath, notFoundFile),
       })
     }
+
+    const routeFile = this.findFile(files, SPECIAL_FILES.ROUTE)
+    if (routeFile) {
+      const apiRoute = await this.processApiRouteFile(relativePath, routeFile)
+      apiRoutes.push(apiRoute)
+    }
   }
 
   private findFile(files: string[], baseName: string): string | undefined {
@@ -327,6 +343,22 @@ export class AppRouteGenerator {
     })
   }
 
+  private sortApiRoutes(routes: ApiRouteEntry[]): ApiRouteEntry[] {
+    return routes.sort((a, b) => {
+      if (!a.isDynamic && b.isDynamic)
+        return -1
+      if (a.isDynamic && !b.isDynamic)
+        return 1
+
+      const aDepth = a.path.split('/').length
+      const bDepth = b.path.split('/').length
+      if (aDepth !== bDepth)
+        return aDepth - bDepth
+
+      return a.path.localeCompare(b.path)
+    })
+  }
+
   private sortLayouts(layouts: LayoutEntry[]): LayoutEntry[] {
     return layouts.sort((a, b) => {
       if (a.path === '/' && b.path !== '/')
@@ -339,6 +371,47 @@ export class AppRouteGenerator {
       return aDepth - bDepth
     })
   }
+
+  private async detectHttpMethods(filePath: string): Promise<string[]> {
+    const fullPath = path.join(this.appDir, filePath)
+    const content = await fs.readFile(fullPath, 'utf-8')
+    const methods: string[] = []
+
+    for (const method of HTTP_METHODS) {
+      const functionExportRegex = new RegExp(
+        `export\\s+(?:async\\s+)?function\\s+${method}\\s*\\(`,
+      )
+      const constExportRegex = new RegExp(
+        `export\\s+(?:async\\s+)?(?:const|let|var)\\s+${method}\\s*=`,
+      )
+
+      if (functionExportRegex.test(content) || constExportRegex.test(content)) {
+        methods.push(method)
+      }
+    }
+
+    return methods
+  }
+
+  private async processApiRouteFile(
+    relativePath: string,
+    fileName: string,
+  ): Promise<ApiRouteEntry> {
+    const filePath = path.join(relativePath, fileName)
+    const routePath = this.pathToRoute(relativePath)
+    const segments = this.parseRouteSegments(relativePath)
+    const params = this.extractParams(segments)
+    const methods = await this.detectHttpMethods(filePath)
+
+    return {
+      path: routePath,
+      filePath,
+      segments,
+      params,
+      isDynamic: params.length > 0,
+      methods,
+    }
+  }
 }
 
 export async function generateAppRouteManifest(

package/src/router/app-types.ts

@@ -42,12 +42,22 @@ export interface NotFoundEntry {
   filePath: string
 }
 
+export interface ApiRouteEntry {
+  path: string
+  filePath: string
+  segments: RouteSegment[]
+  params: string[]
+  isDynamic: boolean
+  methods: string[]
+}
+
 export interface AppRouteManifest {
   routes: AppRouteEntry[]
   layouts: LayoutEntry[]
   loading: LoadingEntry[]
   errors: ErrorEntry[]
   notFound: NotFoundEntry[]
+  apiRoutes: ApiRouteEntry[]
   generated: string
 }
 

package/src/router/vite-plugin.ts

@@ -17,7 +17,7 @@ const DEFAULT_OPTIONS: Required<RariRouterPluginOptions> = {
   outDir: 'dist',
 }
 
-type AppRouterFileType = 'page' | 'layout' | 'loading' | 'error' | 'not-found' | 'server-action'
+type AppRouterFileType = 'page' | 'layout' | 'loading' | 'error' | 'not-found' | 'route' | 'server-action'
 
 interface AppRouterHMRData {
   fileType: AppRouterFileType
@@ -29,6 +29,7 @@ interface AppRouterHMRData {
   metadata?: Record<string, any>
   metadataChanged?: boolean
   actionExports?: string[]
+  methods?: string[]
 }
 
 function getAppRouterFileType(filePath: string): AppRouterFileType | null {
@@ -46,6 +47,8 @@ function getAppRouterFileType(filePath: string): AppRouterFileType | null {
       return 'error'
     case 'not-found':
       return 'not-found'
+    case 'route':
+      return 'route'
     default:
       return null
   }
@@ -130,6 +133,56 @@ function extractMetadata(fileContent: string): Record<string, any> | null {
   }
 }
 
+function detectHttpMethods(fileContent: string): string[] {
+  const methods: string[] = []
+  const httpMethods = ['GET', 'POST', 'PUT', 'DELETE', 'PATCH', 'HEAD', 'OPTIONS']
+
+  for (const method of httpMethods) {
+    const functionExportRegex = new RegExp(
+      `export\\s+(?:async\\s+)?function\\s+${method}\\s*\\(`,
+    )
+    const constExportRegex = new RegExp(
+      `export\\s+(?:async\\s+)?(?:const|let|var)\\s+${method}\\s*=`,
+    )
+
+    if (functionExportRegex.test(fileContent) || constExportRegex.test(fileContent)) {
+      methods.push(method)
+    }
+  }
+
+  return methods
+}
+
+async function notifyApiRouteInvalidation(filePath: string): Promise<void> {
+  try {
+    const response = await fetch('http://localhost:3000/api/rsc/hmr-invalidate-api-route', {
+      method: 'POST',
+      headers: {
+        'Content-Type': 'application/json',
+      },
+      body: JSON.stringify({
+        filePath,
+      }),
+    })
+
+    if (!response.ok) {
+      console.error(`Failed to invalidate API route cache: ${response.statusText}`)
+      return
+    }
+
+    const result = await response.json()
+    if (result.success) {
+      console.warn(`[HMR] API route handler cache invalidated: ${filePath}`)
+    }
+    else {
+      console.error(`[HMR] Failed to invalidate API route cache: ${result.error || 'Unknown error'}`)
+    }
+  }
+  catch (error) {
+    console.error('Failed to notify API route invalidation:', error)
+  }
+}
+
 export function rariRouter(options: RariRouterPluginOptions = {}): Plugin {
   const opts = { ...DEFAULT_OPTIONS, ...options }
 
@@ -321,6 +374,7 @@ export function rariRouter(options: RariRouterPluginOptions = {}): Plugin {
 
             let metadata: Record<string, any> | undefined
             let metadataChanged = false
+            let methods: string[] | undefined
 
             if (fileType === 'page' || fileType === 'layout') {
               try {
@@ -338,6 +392,19 @@ export function rariRouter(options: RariRouterPluginOptions = {}): Plugin {
               }
             }
 
+            if (fileType === 'route') {
+              try {
+                const fileContent = await fs.readFile(file, 'utf-8')
+                methods = detectHttpMethods(fileContent)
+                console.warn(`[HMR] API route methods detected: ${methods.join(', ')}`)
+
+                await notifyApiRouteInvalidation(path.relative(appDir, file))
+              }
+              catch (error) {
+                console.error('Failed to detect HTTP methods:', error)
+              }
+            }
+
             const hmrData: AppRouterHMRData = {
               fileType,
               filePath: path.relative(server.config.root, file),
@@ -347,6 +414,7 @@ export function rariRouter(options: RariRouterPluginOptions = {}): Plugin {
               timestamp: Date.now(),
               metadata,
               metadataChanged,
+              methods,
             }
 
             server.ws.send({
@@ -356,8 +424,9 @@ export function rariRouter(options: RariRouterPluginOptions = {}): Plugin {
             })
 
             const metadataInfo = metadataChanged ? ' [metadata updated]' : ''
+            const methodsInfo = methods ? ` [methods: ${methods.join(', ')}]` : ''
             console.warn(
-              `[HMR] App router ${fileType} changed: ${hmrData.filePath} (affects ${affectedRoutes.length} route${affectedRoutes.length === 1 ? '' : 's'})${metadataInfo}`,
+              `[HMR] App router ${fileType} changed: ${hmrData.filePath} (affects ${affectedRoutes.length} route${affectedRoutes.length === 1 ? '' : 's'})${metadataInfo}${methodsInfo}`,
             )
           }, DEBOUNCE_DELAY)
 

package/src/runtime/api-request.ts

@@ -0,0 +1,158 @@
+export interface RequestData {
+  method: string
+  url: string
+  headers: Record<string, string>
+  body?: string
+  params: Record<string, string>
+}
+
+export interface ResponseData {
+  status: number
+  statusText?: string
+  headers: Record<string, string>
+  body: string
+}
+
+export function createApiRequest(
+  requestData: RequestData,
+  bodyStream?: ReadableStream<Uint8Array>,
+): Request {
+  const url = new URL(requestData.url, 'http://localhost')
+
+  if (requestData.params) {
+    for (const [key, value] of Object.entries(requestData.params)) {
+      url.searchParams.set(key, value)
+    }
+  }
+
+  const headers = new Headers(requestData.headers || {})
+
+  let body: BodyInit | null = null
+  if (bodyStream) {
+    body = bodyStream
+  }
+  else if (requestData.body && requestData.body.length > 0) {
+    const methodSupportsBody = ['POST', 'PUT', 'PATCH', 'DELETE'].includes(
+      requestData.method.toUpperCase(),
+    )
+    if (methodSupportsBody) {
+      body = requestData.body
+    }
+  }
+
+  return new Request(url.toString(), {
+    method: requestData.method,
+    headers,
+    body,
+  })
+}
+
+export async function serializeApiResponse(
+  response: Response | any,
+): Promise<ResponseData> {
+  if (response instanceof Response) {
+    const body = await response.text()
+    const headers: Record<string, string> = {}
+
+    response.headers.forEach((value, key) => {
+      headers[key] = value
+    })
+
+    return {
+      status: response.status,
+      statusText: response.statusText,
+      headers,
+      body,
+    }
+  }
+
+  return {
+    status: 200,
+    statusText: 'OK',
+    headers: {
+      'content-type': 'application/json',
+    },
+    body: JSON.stringify(response),
+  }
+}
+
+export function jsonResponse(data: any, init?: ResponseInit): Response {
+  return new Response(JSON.stringify(data), {
+    ...init,
+    headers: {
+      'content-type': 'application/json',
+      ...init?.headers,
+    },
+  })
+}
+
+export function redirectResponse(url: string, status: number = 307): Response {
+  return new Response(null, {
+    status,
+    headers: {
+      location: url,
+    },
+  })
+}
+
+export function textResponse(text: string, init?: ResponseInit): Response {
+  return new Response(text, {
+    ...init,
+    headers: {
+      'content-type': 'text/plain',
+      ...init?.headers,
+    },
+  })
+}
+
+export function htmlResponse(html: string, init?: ResponseInit): Response {
+  return new Response(html, {
+    ...init,
+    headers: {
+      'content-type': 'text/html',
+      ...init?.headers,
+    },
+  })
+}
+
+export function errorResponse(message: string, status: number = 500): Response {
+  return jsonResponse(
+    {
+      error: true,
+      message,
+    },
+    { status },
+  )
+}
+
+export async function parseJsonBody<T = any>(request: Request): Promise<T> {
+  const contentType = request.headers.get('content-type') || ''
+
+  if (!contentType.includes('application/json')) {
+    throw new Error('Request body is not JSON')
+  }
+
+  return await request.json()
+}
+
+export async function parseFormBody(request: Request): Promise<FormData> {
+  const contentType = request.headers.get('content-type') || ''
+
+  if (!contentType.includes('application/x-www-form-urlencoded')
+    && !contentType.includes('multipart/form-data')) {
+    throw new Error('Request body is not form data')
+  }
+
+  return await request.formData()
+}
+
+export function getParams<T extends Record<string, string> = Record<string, string>>(
+  context: { params: T },
+): T {
+  return context.params
+}
+
+export function getSearchParams(request: Request): URLSearchParams {
+  const url = new URL(request.url)
+  return url.searchParams
+}

package/src/server.ts

@@ -1,3 +1,14 @@
+export type {
+  ApiRouteHandlers,
+  RouteContext,
+  RouteHandler,
+} from './api-routes'
+
+export { RariResponse } from './api-routes'
+
+export type Request = globalThis.Request
+export type Response = globalThis.Response
+
 export { headers } from './async-context'
 
 export type {

package/src/vite/index.ts

@@ -1341,8 +1341,13 @@ export async function renderApp() {
     `
       : 'const wrappedContent = contentToRender;'}
 
-    const root = createRoot(rootElement);
-    root.render(wrappedContent);
+    if (hasSSRContent) {
+      hydrateRoot(rootElement, wrappedContent);
+      isInitialHydration = false;
+    } else {
+      const root = createRoot(rootElement);
+      root.render(wrappedContent);
+    }
   } catch (error) {
     console.error('[Rari] Error rendering app:', error);
     rootElement.innerHTML = \`