@farm.js/core 0.1.0-beta.23 → 0.1.0-beta.25

package/dist/server.cjs

@@ -580,11 +580,11 @@ function resolveFarmServerHealthConfig(config) {
   return Object.freeze({ enabled: true, livenessPath, readinessPath });
 }
 function normalizeHealthPath(value, optionName) {
-  const path27 = value.trim();
-  if (!path27.startsWith("/") || path27.includes("?") || path27.includes("#") || path27.includes("*")) {
+  const path28 = value.trim();
+  if (!path28.startsWith("/") || path28.includes("?") || path28.includes("#") || path28.includes("*")) {
     throw new TypeError(`${optionName} must be an absolute pathname without a query or wildcard`);
   }
-  return path27.length > 1 ? path27.replace(/\/+$/, "") || "/" : path27;
+  return path28.length > 1 ? path28.replace(/\/+$/, "") || "/" : path28;
 }
 function parseBodySizeLimit(value, optionName = "bodySizeLimit") {
   if (typeof value === "number") {
@@ -681,7 +681,7 @@ async function readNodeRequestBody(request, limit) {
     request.resume?.();
     throw error;
   }
-  return await new Promise((resolve6, reject) => {
+  return await new Promise((resolve7, reject) => {
     const chunks = [];
     let total = 0;
     let settled = false;
@@ -710,7 +710,7 @@ async function readNodeRequestBody(request, limit) {
       if (settled) return;
       settled = true;
       cleanup();
-      resolve6(Buffer.concat(chunks, total));
+      resolve7(Buffer.concat(chunks, total));
     }, "onEnd");
     const onError = /* @__PURE__ */ __name((error) => rejectOnce(error), "onError");
     request.on("data", onData);
@@ -939,22 +939,22 @@ async function prepareFarmWorkflowsForNitro(config) {
   }
   const root = config.root || process.cwd();
   const distDir = config.distDir || ".farm";
-  const fs9 = await import("fs/promises");
-  const path27 = await import("path");
-  const generatedDir = path27.join(root, distDir, ".nitro", "farm-workflows");
-  await fs9.mkdir(generatedDir, { recursive: true });
+  const fs10 = await import("fs/promises");
+  const path28 = await import("path");
+  const generatedDir = path28.join(root, distDir, ".nitro", "farm-workflows");
+  await fs10.mkdir(generatedDir, { recursive: true });
   const tasks = {};
   const scheduledTasks = createScheduledTasks(workflows);
   for (const workflow of workflows) {
-    const wrapperPath = path27.join(generatedDir, `${safeFileName(workflow.id)}.mjs`);
-    await fs9.writeFile(wrapperPath, createNitroTaskWrapper(workflow), "utf8");
+    const wrapperPath = path28.join(generatedDir, `${safeFileName(workflow.id)}.mjs`);
+    await fs10.writeFile(wrapperPath, createNitroTaskWrapper(workflow), "utf8");
     tasks[workflow.id] = {
       handler: wrapperPath,
       description: workflow.description || `Farm workflow ${workflow.id}`
     };
   }
-  const handlerPath = path27.join(generatedDir, "http-handler.mjs");
-  await fs9.writeFile(
+  const handlerPath = path28.join(generatedDir, "http-handler.mjs");
+  await fs10.writeFile(
     handlerPath,
     createNitroWorkflowHTTPHandler(
       workflowConfig,
@@ -963,8 +963,8 @@ async function prepareFarmWorkflowsForNitro(config) {
     ),
     "utf8"
   );
-  const manifestPath = path27.join(generatedDir, "manifest.json");
-  await fs9.writeFile(
+  const manifestPath = path28.join(generatedDir, "manifest.json");
+  await fs10.writeFile(
     manifestPath,
     JSON.stringify(
       {
@@ -1045,22 +1045,22 @@ function resolveWorkflowDefinition(module2) {
   return null;
 }
 async function findWorkflowFiles(root, dirs) {
-  const fs9 = await import("fs/promises");
-  const path27 = await import("path");
+  const fs10 = await import("fs/promises");
+  const path28 = await import("path");
   const files = [];
   for (const dir of dirs) {
-    const absoluteDir = path27.isAbsolute(dir) ? dir : path27.join(root, dir);
+    const absoluteDir = path28.isAbsolute(dir) ? dir : path28.join(root, dir);
     if (!await pathExists(absoluteDir)) continue;
     await walkWorkflowDir(absoluteDir, files);
   }
   return files.sort();
 }
 async function walkWorkflowDir(dir, files) {
-  const fs9 = await import("fs/promises");
-  const path27 = await import("path");
-  const entries = await fs9.readdir(dir, { withFileTypes: true });
+  const fs10 = await import("fs/promises");
+  const path28 = await import("path");
+  const entries = await fs10.readdir(dir, { withFileTypes: true });
   for (const entry of entries) {
-    const filePath = path27.join(dir, entry.name);
+    const filePath = path28.join(dir, entry.name);
     if (entry.isDirectory()) {
       if (entry.name === "node_modules" || entry.name.startsWith(".")) continue;
       await walkWorkflowDir(filePath, files);
@@ -1072,20 +1072,20 @@ async function walkWorkflowDir(dir, files) {
   }
 }
 async function pathExists(filePath) {
-  const fs9 = await import("fs/promises");
-  return fs9.access(filePath).then(() => true).catch(() => false);
+  const fs10 = await import("fs/promises");
+  return fs10.access(filePath).then(() => true).catch(() => false);
 }
 function isWorkflowFile(fileName) {
   return /\.(?:ts|tsx|js|jsx|mjs|cjs)$/.test(fileName) && !/\.d\.[cm]?ts$/.test(fileName);
 }
 async function loadWorkflowModule(filePath, root) {
-  const fs9 = await import("fs/promises");
-  const path27 = await import("path");
+  const fs10 = await import("fs/promises");
+  const path28 = await import("path");
   const { pathToFileURL: pathToFileURL5 } = await import("url");
   const { build } = await import("esbuild");
-  const outDir = path27.join(root, ".farm", ".workflow-loader");
-  await fs9.mkdir(outDir, { recursive: true });
-  const outfile = path27.join(
+  const outDir = path28.join(root, ".farm", ".workflow-loader");
+  await fs10.mkdir(outDir, { recursive: true });
+  const outfile = path28.join(
     outDir,
     `workflow-${Date.now()}-${Math.random().toString(36).slice(2)}.mjs`
   );
@@ -1109,7 +1109,7 @@ async function loadWorkflowModule(filePath, root) {
       `${pathToFileURL5(outfile).href}?t=${Date.now()}`
     );
   } finally {
-    await fs9.unlink(outfile).catch(() => void 0);
+    await fs10.unlink(outfile).catch(() => void 0);
   }
 }
 function workflowIdFromFile(root, filePath) {
@@ -1384,7 +1384,7 @@ function normalizeCronJob(name, job) {
   if (!job || typeof job !== "object" || Array.isArray(job)) {
     throw new TypeError(`Farm cron ${JSON.stringify(name)} must be a configuration object.`);
   }
-  const path27 = normalizeCronPath(name, job.path);
+  const path28 = normalizeCronPath(name, job.path);
   const rawSchedule = Array.isArray(job.schedule) ? job.schedule : [job.schedule];
   const schedule = [...new Set(rawSchedule.map((value) => normalizeCronExpression(name, value)))];
   if (schedule.length === 0) {
@@ -1393,7 +1393,7 @@ function normalizeCronJob(name, job) {
   return {
     name,
     schedule,
-    path: path27,
+    path: path28,
     description: job.description?.trim() || void 0
   };
 }
@@ -1401,13 +1401,13 @@ function normalizeCronPath(name, value) {
   if (typeof value !== "string" || !value.trim().startsWith("/")) {
     throw new TypeError(`Farm cron ${JSON.stringify(name)} path must start with "/".`);
   }
-  const path27 = value.trim();
-  if (path27.startsWith("//") || path27.includes("?") || path27.includes("#")) {
+  const path28 = value.trim();
+  if (path28.startsWith("//") || path28.includes("?") || path28.includes("#")) {
     throw new TypeError(
       `Farm cron ${JSON.stringify(name)} path must be an application pathname without a host, query, or hash.`
     );
   }
-  return path27.length > 1 ? path27.replace(/\/+$/, "") : path27;
+  return path28.length > 1 ? path28.replace(/\/+$/, "") : path28;
 }
 function normalizeCronExpression(name, value) {
   if (typeof value !== "string") {
@@ -2687,7 +2687,7 @@ var init_server_action_security = __esm({
 
 // src/image-config.ts
 function resolveFarmImageConfig(config) {
-  const path27 = normalizeImagePath(config?.path ?? DEFAULT_FARM_IMAGE_PATH);
+  const path28 = normalizeImagePath(config?.path ?? DEFAULT_FARM_IMAGE_PATH);
   const deviceSizes = normalizeIntegerList(
     config?.deviceSizes ?? DEFAULT_FARM_IMAGE_DEVICE_SIZES,
     "images.deviceSizes"
@@ -2715,7 +2715,7 @@ function resolveFarmImageConfig(config) {
   );
   return Object.freeze({
     provider: config?.provider ?? "auto",
-    path: path27,
+    path: path28,
     domains: Object.freeze([
       ...new Set(
         (config?.domains ?? []).map((domain) => domain.trim().toLowerCase()).filter(Boolean)
@@ -2754,11 +2754,11 @@ function getPublicFarmImageConfig(config) {
   };
 }
 function normalizeImagePath(value) {
-  const path27 = value.trim().replace(/\/+$/, "") || "/";
-  if (!path27.startsWith("/") || path27.includes("?") || path27.includes("#")) {
+  const path28 = value.trim().replace(/\/+$/, "") || "/";
+  if (!path28.startsWith("/") || path28.includes("?") || path28.includes("#")) {
     throw new TypeError("images.path must be an absolute pathname without a query or hash");
   }
-  return path27;
+  return path28;
 }
 function normalizeIntegerList(values, name, max) {
   if (values.length === 0) {
@@ -3621,9 +3621,9 @@ function getFarmIntegrationPluginOwner(plugin) {
   const value = plugin[FARM_INTEGRATION_PLUGIN_OWNER];
   return value && typeof value === "object" ? value : void 0;
 }
-function defineTypedIntegrationRoute(method, path27, input) {
+function defineTypedIntegrationRoute(method, path28, input) {
   return {
-    path: path27,
+    path: path28,
     method,
     middleware: input.middleware,
     before: input.before,
@@ -3633,7 +3633,7 @@ function defineTypedIntegrationRoute(method, path27, input) {
     input: normalizeIntegrationRouteInputSchemas(input),
     handler: input.handler,
     __operation: defineIntegrationAPIOperation({
-      path: path27,
+      path: path28,
       method,
       bodyFormat: input.bodyFormat,
       responseFormat: input.responseFormat,
@@ -3645,52 +3645,52 @@ function defineTypedIntegrationRoute(method, path27, input) {
 }
 function createIntegrationRouteFactory() {
   return {
-    get(path27, input) {
+    get(path28, input) {
       return defineTypedIntegrationRoute(
         "GET",
-        path27,
+        path28,
         input
       );
     },
-    post(path27, input) {
+    post(path28, input) {
       return defineTypedIntegrationRoute(
         "POST",
-        path27,
+        path28,
         {
           bodyFormat: "json",
           ...input
         }
       );
     },
-    put(path27, input) {
+    put(path28, input) {
       return defineTypedIntegrationRoute(
         "PUT",
-        path27,
+        path28,
         {
           bodyFormat: "json",
           ...input
         }
       );
     },
-    patch(path27, input) {
-      return defineTypedIntegrationRoute("PATCH", path27, {
+    patch(path28, input) {
+      return defineTypedIntegrationRoute("PATCH", path28, {
         bodyFormat: "json",
         ...input
       });
     },
-    delete(path27, input) {
-      return defineTypedIntegrationRoute("DELETE", path27, {
+    delete(path28, input) {
+      return defineTypedIntegrationRoute("DELETE", path28, {
         bodyFormat: "json",
         ...input
       });
     },
-    options(path27, input) {
-      return defineTypedIntegrationRoute("OPTIONS", path27, input);
+    options(path28, input) {
+      return defineTypedIntegrationRoute("OPTIONS", path28, input);
     },
-    head(path27, input) {
+    head(path28, input) {
       return defineTypedIntegrationRoute(
         "HEAD",
-        path27,
+        path28,
         input
       );
     }
@@ -3964,8 +3964,8 @@ async function parseIntegrationConfigSchema(integration, schema, value) {
 function createIntegrationConfigValidationError(integration, error) {
   const issues = Array.isArray(error.issues) && error.issues.length > 0 ? error.issues.map((issue) => {
     const normalizedPath = normalizeIntegrationValidationPath(issue.path);
-    const path27 = normalizedPath.length ? `${normalizedPath.join(".")}: ` : "";
-    return `${path27}${issue.message || "Invalid config"}`;
+    const path28 = normalizedPath.length ? `${normalizedPath.join(".")}: ` : "";
+    return `${path28}${issue.message || "Invalid config"}`;
   }).join("; ") : error.message || "Invalid config";
   return new Error(`Integration "${integration.type}" config validation failed: ${issues}`);
 }
@@ -4662,8 +4662,8 @@ function normalizeIntegrationValidationIssues(source, error) {
     }
   ];
 }
-function normalizeIntegrationValidationPath(path27) {
-  return (path27 || []).map((segment) => {
+function normalizeIntegrationValidationPath(path28) {
+  return (path28 || []).map((segment) => {
     const key = typeof segment === "object" && segment !== null && "key" in segment ? segment.key : segment;
     return typeof key === "symbol" ? key.description || key.toString() : key;
   });
@@ -5461,8 +5461,8 @@ function createFarmDeploymentMismatchResponse(mismatch) {
     }
   );
 }
-function createFarmDeploymentCookie(deploymentId, path27 = "/", secure = false) {
-  const normalizedPath = path27.startsWith("/") ? path27 : `/${path27}`;
+function createFarmDeploymentCookie(deploymentId, path28 = "/", secure = false) {
+  const normalizedPath = path28.startsWith("/") ? path28 : `/${path28}`;
   return [
     `${FARM_DEPLOYMENT_COOKIE}=${encodeURIComponent(deploymentId)}`,
     `Path=${normalizedPath}`,
@@ -6075,11 +6075,11 @@ var init_type_generator = __esm({
           routeGroups.get(key).push(route);
         }
         const nestedStructure = {};
-        for (const [path27, routeList] of routeGroups) {
+        for (const [path28, routeList] of routeGroups) {
           const route = routeList[0];
           const importPath = this.getRouteImportPath(route, options.outFile);
           const routeName = this.pathToRouteName(route.path);
-          const cleanPath = path27 === "/api" ? "" : path27.replace(/^\/api\//, "");
+          const cleanPath = path28 === "/api" ? "" : path28.replace(/^\/api\//, "");
           const parts = cleanPath ? cleanPath.split("/") : [];
           const allMethods = routeList.flatMap((r) => r.methods);
           for (const method of allMethods) {
@@ -6138,8 +6138,8 @@ ${typeExports}
         const relativeImport = (0, import_path7.relative)((0, import_path7.dirname)(outFile), route.filePath).replace(/\\/g, "/").replace(/\.(ts|tsx|js|jsx)$/, "");
         return relativeImport.startsWith(".") ? relativeImport : `./${relativeImport}`;
       }
-      pathToRouteName(path27) {
-        return (path27 === "/api" ? "root" : path27.replace(/^\/api\//, "")).replace(/\//g, "_").replace(/[^a-zA-Z0-9_]/g, "");
+      pathToRouteName(path28) {
+        return (path28 === "/api" ? "root" : path28.replace(/^\/api\//, "")).replace(/\//g, "_").replace(/[^a-zA-Z0-9_]/g, "");
       }
       structureToTypeString(obj, indent) {
         const spaces = "  ".repeat(indent);
@@ -6159,15 +6159,15 @@ ${typeExports}
       toTypePropertyKey(key) {
         return /^[$A-Z_][0-9A-Z_$]*$/i.test(key) ? key : JSON.stringify(key);
       }
-      getBaseExportName(path27) {
-        const cleanPath = path27.replace(/^\/api\//, "");
+      getBaseExportName(path28) {
+        const cleanPath = path28.replace(/^\/api\//, "");
         if (cleanPath === "") {
           return "api";
         }
         return cleanPath;
       }
-      getExportName(path27, method) {
-        const cleanPath = path27.replace(/^\/api\//, "");
+      getExportName(path28, method) {
+        const cleanPath = path28.replace(/^\/api\//, "");
         if (cleanPath === "") {
           return method.toLowerCase();
         }
@@ -10573,37 +10573,37 @@ function sanitizeDocsConfig(config) {
   return cloneSerializable(config) || {};
 }
 async function findDocsConfigPath(rootDir, configPath) {
-  const { existsSync: existsSync16 } = await import("fs");
+  const { existsSync: existsSync17 } = await import("fs");
   const root = import_path9.default.resolve(rootDir || process.cwd());
   if (configPath) {
     const resolvedPath = import_path9.default.isAbsolute(configPath) ? configPath : import_path9.default.join(root, configPath);
-    if (!existsSync16(resolvedPath)) {
+    if (!existsSync17(resolvedPath)) {
       throw new Error(`Could not find docs config at ${configPath}.`);
     }
     return import_path9.default.resolve(resolvedPath);
   }
   for (const filename of DOCS_CONFIG_FILENAMES) {
     const resolvedPath = import_path9.default.join(root, filename);
-    if (existsSync16(resolvedPath)) {
+    if (existsSync17(resolvedPath)) {
       return resolvedPath;
     }
   }
   return void 0;
 }
 async function loadDocsConfig(rootDir, configPath) {
-  const fs9 = await import("fs/promises");
+  const fs10 = await import("fs/promises");
   const { pathToFileURL: pathToFileURL5 } = await import("url");
   const root = import_path9.default.resolve(rootDir || process.cwd());
   const resolvedPath = await findDocsConfigPath(root, configPath);
   if (!resolvedPath) return void 0;
   try {
     if (resolvedPath.endsWith(".json")) {
-      const content = await fs9.readFile(resolvedPath, "utf8");
+      const content = await fs10.readFile(resolvedPath, "utf8");
       return { config: JSON.parse(content), configPath: resolvedPath };
     }
     const { build } = await import("esbuild");
     const configCacheDir = import_path9.default.join(root, ".farm", ".config-loader");
-    await fs9.mkdir(configCacheDir, { recursive: true });
+    await fs10.mkdir(configCacheDir, { recursive: true });
     const modulePath = import_path9.default.join(
       configCacheDir,
       `docs-config-${Date.now()}-${Math.random().toString(36).slice(2)}.mjs`
@@ -10629,7 +10629,7 @@ async function loadDocsConfig(rootDir, configPath) {
         moduleUrl
       );
     } finally {
-      await fs9.unlink(modulePath).catch(() => void 0);
+      await fs10.unlink(modulePath).catch(() => void 0);
     }
     return {
       config: importedConfig.default || importedConfig,
@@ -10820,7 +10820,7 @@ async function resolveConfig(userConfig, mode) {
   return resolved;
 }
 async function loadConfig(rootDir, configPath, mode = process.env.NODE_ENV === "production" ? "production" : "development", loadEnvironment) {
-  const { existsSync: existsSync16 } = await import("fs");
+  const { existsSync: existsSync17 } = await import("fs");
   const loadEnv = loadEnvironment || (await import("vite")).loadEnv;
   const root = rootDir || process.cwd();
   const loadedEnv = loadEnv(mode, root, "");
@@ -10844,7 +10844,7 @@ async function loadConfig(rootDir, configPath, mode = process.env.NODE_ENV === "
     try {
       const absolutePath = relativePath2.startsWith("/") ? relativePath2 : import_path9.default.join(root, relativePath2);
       const normalizedPath = import_path9.default.resolve(absolutePath);
-      if (!existsSync16(normalizedPath)) {
+      if (!existsSync17(normalizedPath)) {
         continue;
       }
       const loadedConfig = await loadFarmConfigFile(normalizedPath, { root });
@@ -11675,8 +11675,8 @@ var init_generator = __esm({
           }
           routeGroups.get(key).push(route);
         }
-        for (const [path27, routeList] of routeGroups) {
-          const openAPIPath = this.convertToOpenAPIPath(path27);
+        for (const [path28, routeList] of routeGroups) {
+          const openAPIPath = this.convertToOpenAPIPath(path28);
           spec.paths[openAPIPath] = {};
           for (const route of routeList) {
             for (const method of route.methods) {
@@ -11690,8 +11690,8 @@ var init_generator = __esm({
       /**
        * Convert Farm.js API path to OpenAPI path format
        */
-      convertToOpenAPIPath(path27) {
-        return path27.replace(/^\/api/, "");
+      convertToOpenAPIPath(path28) {
+        return path28.replace(/^\/api/, "");
       }
       /**
        * Extract request body schema from endpoint
@@ -11853,8 +11853,8 @@ var init_generator = __esm({
       /**
        * Generate operation summary
        */
-      generateSummary(path27, method) {
-        const cleanPath = path27.replace(/^\/api\//, "");
+      generateSummary(path28, method) {
+        const cleanPath = path28.replace(/^\/api\//, "");
         const pathParts = cleanPath.split("/");
         const lastPart = pathParts[pathParts.length - 1];
         const action = method === "GET" ? "Get" : method === "POST" ? "Create" : method === "PUT" ? "Update" : method === "DELETE" ? "Delete" : method === "PATCH" ? "Update" : method;
@@ -11863,22 +11863,22 @@ var init_generator = __esm({
       /**
        * Generate operation description
        */
-      generateDescription(path27, method) {
-        const cleanPath = path27.replace(/^\/api\//, "");
+      generateDescription(path28, method) {
+        const cleanPath = path28.replace(/^\/api\//, "");
         return `${method} ${cleanPath} endpoint`;
       }
       /**
        * Generate operation ID
        */
-      generateOperationId(path27, method) {
-        const cleanPath = path27.replace(/^\/api\//, "").replace(/\//g, "_");
+      generateOperationId(path28, method) {
+        const cleanPath = path28.replace(/^\/api\//, "").replace(/\//g, "_");
         return `${method.toLowerCase()}_${cleanPath}`;
       }
       /**
        * Generate tags for grouping operations
        */
-      generateTags(path27) {
-        const cleanPath = path27.replace(/^\/api\//, "");
+      generateTags(path28) {
+        const cleanPath = path28.replace(/^\/api\//, "");
         const pathParts = cleanPath.split("/");
         if (pathParts.length > 1) {
           return [pathParts[0]];
@@ -11890,13 +11890,13 @@ var init_generator = __esm({
        */
       async generateSpecFile(routes, outputPath) {
         const spec = await this.generateSpec(routes);
-        const fs9 = require("fs");
-        const path27 = require("path");
-        const dir = path27.dirname(outputPath);
-        if (!fs9.existsSync(dir)) {
-          fs9.mkdirSync(dir, { recursive: true });
+        const fs10 = require("fs");
+        const path28 = require("path");
+        const dir = path28.dirname(outputPath);
+        if (!fs10.existsSync(dir)) {
+          fs10.mkdirSync(dir, { recursive: true });
         }
-        fs9.writeFileSync(outputPath, JSON.stringify(spec, null, 2));
+        fs10.writeFileSync(outputPath, JSON.stringify(spec, null, 2));
       }
     };
     __name(_OpenAPIGenerator, "OpenAPIGenerator");
@@ -14251,8 +14251,8 @@ function toViteModuleId(filePath, root) {
 __name(toViteModuleId, "toViteModuleId");
 async function fileExists(filePath) {
   try {
-    const fs9 = await import("fs/promises");
-    await fs9.access(filePath);
+    const fs10 = await import("fs/promises");
+    await fs10.access(filePath);
     return true;
   } catch {
     return false;
@@ -15675,7 +15675,7 @@ function normalizePositiveDuration(value, fallback, name) {
 }
 __name(normalizePositiveDuration, "normalizePositiveDuration");
 function delay(ms) {
-  return new Promise((resolve6) => setTimeout(resolve6, ms));
+  return new Promise((resolve7) => setTimeout(resolve7, ms));
 }
 __name(delay, "delay");
 function normalizeCacheOptionsTags(options) {
@@ -15826,25 +15826,25 @@ function defineRoutes(input) {
 }
 __name(defineRoutes, "defineRoutes");
 var routesBuilder = {
-  page(path27, options) {
+  page(path28, options) {
     return normalizeProgrammaticRoute({
       kind: "page",
-      path: path27,
+      path: path28,
       ...options
     });
   },
-  layout(path27, options) {
+  layout(path28, options) {
     return normalizeProgrammaticRoute({
       kind: "layout",
-      path: path27,
+      path: path28,
       ...options
     });
   },
-  api(path27, options) {
+  api(path28, options) {
     const { render, runtime, regions, maxDuration, ...methods } = options;
     return normalizeProgrammaticRoute({
       kind: "api",
-      path: path27,
+      path: path28,
       render,
       runtime,
       regions,
@@ -15880,7 +15880,7 @@ function getProgrammaticRouteSearchClientOptions(search) {
   return Object.keys(options).length > 0 ? options : void 0;
 }
 __name(getProgrammaticRouteSearchClientOptions, "getProgrammaticRouteSearchClientOptions");
-function resolveProgrammaticRouteSearch(searchConfig, rawSearch, path27, routePath) {
+function resolveProgrammaticRouteSearch(searchConfig, rawSearch, path28, routePath) {
   const schema = getProgrammaticRouteSearchSchema(searchConfig);
   const search = parseProgrammaticSchema(schema, rawSearch, "search", routePath);
   const options = getProgrammaticRouteSearchOptions(searchConfig);
@@ -15889,7 +15889,7 @@ function resolveProgrammaticRouteSearch(searchConfig, rawSearch, path27, routePa
     schema,
     rawSearch,
     parsedSearch: search,
-    path: path27
+    path: path28
   });
   return { search, canonicalPath };
 }
@@ -16072,7 +16072,7 @@ function createRouteModuleFromProgrammaticPage(route) {
     mod.__farmRouteData = route.data;
     mod.__farmRouteParsesProps = true;
     mod.__farmResolveRouteProps = (props) => resolveProgrammaticRouteProps(route, props);
-    mod.__farmResolveRouteCanonicalPath = (rawSearch, path27) => resolveProgrammaticRouteSearch(route.search, rawSearch, path27, route.path).canonicalPath;
+    mod.__farmResolveRouteCanonicalPath = (rawSearch, path28) => resolveProgrammaticRouteSearch(route.search, rawSearch, path28, route.path).canonicalPath;
   }
   if (route.pending || route.error || route.notFound) {
     mod.__farmRouteComponents = {
@@ -16826,6 +16826,37 @@ function stripUseClientDirective(content) {
   return content.replace(/^\s*(["'])use client\1\s*;?\s*/, "");
 }
 __name(stripUseClientDirective, "stripUseClientDirective");
+function hasAsyncDefaultExport(content) {
+  if (!content) return false;
+  const tokens = tokenizeModuleSource(content);
+  for (let index = 0; index < tokens.length - 2; index++) {
+    const token = tokens[index];
+    if (token.kind !== "identifier" || token.value !== "export") continue;
+    if (tokens[index - 1]?.value === ".") continue;
+    if (tokens[index + 1]?.value !== "default") continue;
+    const exported = tokens[index + 2];
+    if (exported.kind === "identifier" && exported.value === "async") {
+      return true;
+    }
+    if (exported.kind === "identifier" && !["function", "class"].includes(exported.value) && tokens[index + 3]?.value !== "(" && isAsyncLocalDeclaration(tokens, exported.value)) {
+      return true;
+    }
+  }
+  return false;
+}
+__name(hasAsyncDefaultExport, "hasAsyncDefaultExport");
+function isAsyncLocalDeclaration(tokens, name) {
+  for (let index = 0; index < tokens.length - 2; index++) {
+    if (tokens[index].value === "async" && tokens[index + 1]?.value === "function" && tokens[index + 2]?.value === name) {
+      return true;
+    }
+    if (tokens[index].value === name && tokens[index + 1]?.value === "=" && tokens[index + 2]?.value === "async") {
+      return true;
+    }
+  }
+  return false;
+}
+__name(isAsyncLocalDeclaration, "isAsyncLocalDeclaration");
 function parseClientModuleMetadata(content, inspectIslandExport) {
   if (!content) {
     return {
@@ -16881,6 +16912,14 @@ function inspectClientModuleMetadata(resolvedPath, root, visited, inspectIslandE
     }
   }
   const shouldHydrate = parsed.hasHydrateExport || importsClientBoundary;
+  if (shouldHydrate && hasAsyncDefaultExport(content)) {
+    return {
+      isClientComponent: false,
+      shouldHydrate: false,
+      islandStrategy: null,
+      suppressedAsyncHydration: true
+    };
+  }
   return {
     isClientComponent: false,
     shouldHydrate,
@@ -17596,6 +17635,7 @@ var _RouteManager = class _RouteManager {
         shouldHydrate: metadata.shouldHydrate,
         isClientComponent: metadata.isClientComponent,
         islandStrategy: metadata.islandStrategy,
+        suppressedAsyncHydration: metadata.suppressedAsyncHydration,
         search: getProgrammaticRouteSearchClientOptions(programmaticPage?.search),
         segments: entry.route.segments.map((seg) => ({
           segment: seg.segment,
@@ -20843,6 +20883,15 @@ _setFarmThemeServerSnapshotResolver(() => {
 // src/server/renderer.ts
 var cachedClerkProvider = null;
 var importRuntimeModule = new Function("specifier", "return import(specifier);");
+var warnedSuppressedAsyncHydrationModules = /* @__PURE__ */ new Set();
+function warnSuppressedAsyncHydrationOnce(modulePath) {
+  if (warnedSuppressedAsyncHydrationModules.has(modulePath)) return;
+  warnedSuppressedAsyncHydrationModules.add(modulePath);
+  logger.warn(
+    `${modulePath} is an async server component that imports client components. React cannot hydrate async components in the browser, so this route stays server-rendered and its client imports are not interactive. Move the interactive UI into a "use client" child rendered by a synchronous page, or enable experimental server components support.`
+  );
+}
+__name(warnSuppressedAsyncHydrationOnce, "warnSuppressedAsyncHydrationOnce");
 function hasRequestHeader(req, name) {
   const value = req.headers[name.toLowerCase()];
   return Array.isArray(value) ? value.length > 0 : Boolean(value);
@@ -21517,6 +21566,9 @@ var _ServerRenderer = class _ServerRenderer {
         })
       );
       const shouldHydrate = moduleMetadata.shouldHydrate;
+      if (moduleMetadata.suppressedAsyncHydration) {
+        warnSuppressedAsyncHydrationOnce(route.modulePath);
+      }
       const layoutHydrationMetadata = layouts.map((layout2) => {
         const manifestEntry = routeManifest.layouts.find(
           (entry) => entry.pattern === layout2.pattern
@@ -22014,7 +22066,7 @@ var _ServerRenderer = class _ServerRenderer {
     }
   }
   async renderWithSSR(element, req, res, clearMiddlewareData, options = {}) {
-    return new Promise((resolve6, reject) => {
+    return new Promise((resolve7, reject) => {
       const streamStartTime = Date.now();
       const observabilityRoute = options.observabilityRoute || req.__FARM_ROUTE__ || req.url || "/";
       const deploymentId = this.getDeploymentId();
@@ -22214,7 +22266,7 @@ ${getFarmI18nClientSnapshot() ? `window.__FARM_I18N__ = ${serializeInlineValue2(
                 route: observabilityRoute,
                 durationMs: Date.now() - streamStartTime
               });
-              resolve6();
+              resolve7();
             }
           });
           res.write(shell);
@@ -24740,8 +24792,8 @@ init_app_markdown();
 init_response();
 init_integrations();
 init_devtools_config();
-var fs7 = __toESM(require("fs"));
-var path25 = __toESM(require("path"));
+var fs8 = __toESM(require("fs"));
+var path26 = __toESM(require("path"));
 init_layers();
 
 // src/environment-vite.ts
@@ -25088,7 +25140,7 @@ function transformError(id, message) {
 __name(transformError, "transformError");
 
 // package.json
-var version = "0.1.0-beta.23";
+var version = "0.1.0-beta.25";
 
 // src/version.ts
 var FARM_VERSION = version;
@@ -25122,8 +25174,8 @@ __name(reportAfterError, "reportAfterError");
 function createAfterRequestState(reportError = defaultAfterErrorReporter) {
   let resolveResponseFinished;
   let responseFinished = false;
-  const responseFinishedPromise = new Promise((resolve6) => {
-    resolveResponseFinished = resolve6;
+  const responseFinishedPromise = new Promise((resolve7) => {
+    resolveResponseFinished = resolve7;
   });
   const state = {
     completion: Promise.resolve(),
@@ -25235,8 +25287,8 @@ function after(callback) {
     throw new Error("after() cannot schedule work after the request lifecycle has completed.");
   }
   let start;
-  const ready = new Promise((resolve6) => {
-    start = resolve6;
+  const ready = new Promise((resolve7) => {
+    start = resolve7;
   });
   const result = ready.then(callback);
   state.tasks.push({ result, start });
@@ -25285,6 +25337,34 @@ function _withAfterNodeMiddleware(handler) {
 }
 __name(_withAfterNodeMiddleware, "_withAfterNodeMiddleware");
 
+// src/dev-static.ts
+var fs7 = __toESM(require("fs"));
+var path17 = __toESM(require("path"));
+function devServableFileExists(pathname, baseDirs) {
+  let decodedPathname;
+  try {
+    decodedPathname = decodeURIComponent(pathname);
+  } catch {
+    return false;
+  }
+  const relativePathname = decodedPathname.replace(/^\/+/, "");
+  if (!relativePathname) return false;
+  for (const baseDir of baseDirs) {
+    if (typeof baseDir !== "string" || baseDir.length === 0) continue;
+    const resolvedBase = path17.resolve(baseDir);
+    const candidate = path17.resolve(resolvedBase, relativePathname);
+    if (!candidate.startsWith(resolvedBase + path17.sep)) continue;
+    try {
+      if (fs7.existsSync(candidate) && fs7.statSync(candidate).isFile()) {
+        return true;
+      }
+    } catch {
+    }
+  }
+  return false;
+}
+__name(devServableFileExists, "devServableFileExists");
+
 // src/vite.ts
 init_deployment();
 init_image_config();
@@ -25730,11 +25810,11 @@ function isPotentialProgrammaticRouteSourceFile(normalizedFile, srcDirSlug) {
 }
 __name(isPotentialProgrammaticRouteSourceFile, "isPotentialProgrammaticRouteSourceFile");
 function fileContainsProgrammaticPageRoute(file) {
-  if (!fs7.existsSync(file)) {
+  if (!fs8.existsSync(file)) {
     return false;
   }
   try {
-    return scanProgrammaticPagePaths(fs7.readFileSync(file, "utf8")).length > 0;
+    return scanProgrammaticPagePaths(fs8.readFileSync(file, "utf8")).length > 0;
   } catch {
     return false;
   }
@@ -25742,7 +25822,7 @@ function fileContainsProgrammaticPageRoute(file) {
 __name(fileContainsProgrammaticPageRoute, "fileContainsProgrammaticPageRoute");
 function rewriteEarlySsrRelativeImports(options) {
   const cleanId = options.id.split("?", 1)[0];
-  if (!path25.isAbsolute(cleanId) || cleanId.replace(/\\/g, "/").includes("/node_modules/")) {
+  if (!path26.isAbsolute(cleanId) || cleanId.replace(/\\/g, "/").includes("/node_modules/")) {
     return null;
   }
   const replacements = [];
@@ -25762,7 +25842,7 @@ function rewriteEarlySsrRelativeImports(options) {
     const suffixIndex = source.value.search(/[?#]/);
     const sourcePath = suffixIndex === -1 ? source.value : source.value.slice(0, suffixIndex);
     const suffix = suffixIndex === -1 ? "" : source.value.slice(suffixIndex);
-    const resolvedPath = path25.resolve(path25.dirname(cleanId), sourcePath);
+    const resolvedPath = path26.resolve(path26.dirname(cleanId), sourcePath);
     replacements.push({
       start: source.start,
       end: source.end,
@@ -25841,7 +25921,7 @@ function farmPlugin(options = {}, initialPluginManager) {
         ...layerRoots.length ? {
           server: {
             fs: {
-              allow: [path25.resolve(options.root || process.cwd()), ...layerRoots]
+              allow: [path26.resolve(options.root || process.cwd()), ...layerRoots]
             }
           }
         } : {}
@@ -25872,13 +25952,13 @@ function farmPlugin(options = {}, initialPluginManager) {
         },
         server
       );
-      const globalsCSSPath = path25.join(server.config.root, "src/app/globals.css");
-      if (!fs7.existsSync(globalsCSSPath)) {
-        const appDir = path25.join(server.config.root, "src/app");
-        if (!fs7.existsSync(appDir)) {
-          fs7.mkdirSync(appDir, { recursive: true });
+      const globalsCSSPath = path26.join(server.config.root, "src/app/globals.css");
+      if (!fs8.existsSync(globalsCSSPath)) {
+        const appDir = path26.join(server.config.root, "src/app");
+        if (!fs8.existsSync(appDir)) {
+          fs8.mkdirSync(appDir, { recursive: true });
         }
-        fs7.writeFileSync(globalsCSSPath, defaultGlobalCSS);
+        fs8.writeFileSync(globalsCSSPath, defaultGlobalCSS);
       }
       await farmApp.initialize();
       const farmConfig = farmApp.getConfig();
@@ -25897,10 +25977,10 @@ function farmPlugin(options = {}, initialPluginManager) {
         });
       }
       const sourceRoots = getFarmSourceRoots(farmConfig);
-      server.watcher.add(sourceRoots.map((source) => path25.join(source.root, source.srcDir)));
+      server.watcher.add(sourceRoots.map((source) => path26.join(source.root, source.srcDir)));
       if (farmConfig.i18n.enabled) {
         server.watcher.add(
-          farmConfig.i18n.messages.includes("{locale}") ? path25.dirname(farmConfig.i18n.messages) : farmConfig.i18n.messages
+          farmConfig.i18n.messages.includes("{locale}") ? path26.dirname(farmConfig.i18n.messages) : farmConfig.i18n.messages
         );
       }
       const workflowConfig = farmConfig.workflows;
@@ -25910,7 +25990,7 @@ function farmPlugin(options = {}, initialPluginManager) {
         ...farmDocsDevRuntime?.getFarmDocsRouteTypeEntries(farmConfig.docs) ?? []
       ], "getExtraRouteTypes");
       const appDirSlugs = sourceRoots.map(
-        (source) => path25.join(source.root, source.srcDir, "app").replace(/\\/g, "/")
+        (source) => path26.join(source.root, source.srcDir, "app").replace(/\\/g, "/")
       );
       const generateTypeArtifacts = /* @__PURE__ */ __name(async (reason, selection = ALL_TYPE_ARTIFACTS, log = false) => {
         try {
@@ -25950,7 +26030,7 @@ function farmPlugin(options = {}, initialPluginManager) {
       }, "generateTypeArtifacts");
       await generateTypeArtifacts("startup");
       const srcDirSlugs = sourceRoots.map(
-        (source) => path25.join(source.root, source.srcDir).replace(/\\/g, "/")
+        (source) => path26.join(source.root, source.srcDir).replace(/\\/g, "/")
       );
       const layerConfigFiles = new Set(
         farmConfig.layers.map((layer) => layer.configFile?.replace(/\\/g, "/")).filter((file) => Boolean(file))
@@ -26068,7 +26148,7 @@ function farmPlugin(options = {}, initialPluginManager) {
       await apiRouteManager.discoverRoutes();
       let discoveredWorkflows = [];
       const hasWorkflowDirectory = workflowConfig.enabled && workflowConfig.dirs.some(
-        (dir) => fs7.existsSync(path25.isAbsolute(dir) ? dir : path25.join(farmConfig.root, dir))
+        (dir) => fs8.existsSync(path26.isAbsolute(dir) ? dir : path26.join(farmConfig.root, dir))
       );
       if (hasWorkflowDirectory) {
         const { createFarmWorkflowRequestHandler: createFarmWorkflowRequestHandler2, discoverFarmWorkflows: discoverFarmWorkflows2 } = await loadFarmWorkflowsDevRuntime();
@@ -26302,12 +26382,12 @@ window.__FARM_MANIFEST__ = ${inlineValue({
             }
           }
           const farmDocsFontPath = farmDocsFontAssets.get(requestPathname);
-          if ((requestMethod === "GET" || requestMethod === "HEAD") && farmDocsFontPath && fs7.existsSync(farmDocsFontPath)) {
+          if ((requestMethod === "GET" || requestMethod === "HEAD") && farmDocsFontPath && fs8.existsSync(farmDocsFontPath)) {
             res.statusCode = 200;
             res.setHeader("Content-Type", "font/woff2");
             res.setHeader("Cache-Control", "public, max-age=31536000, immutable");
             if (requestMethod === "HEAD") res.end();
-            else fs7.createReadStream(farmDocsFontPath).pipe(res);
+            else fs8.createReadStream(farmDocsFontPath).pipe(res);
             return;
           }
           if (requestMethod === "GET" && (requestPathname === FARM_DEVTOOLS_PATH || requestPathname === `${FARM_DEVTOOLS_PATH}.json`)) {
@@ -26405,7 +26485,7 @@ window.__FARM_MANIFEST__ = ${inlineValue({
                 return null;
               }
               return {
-                source: await fs7.promises.readFile(sourcePath, "utf8"),
+                source: await fs8.promises.readFile(sourcePath, "utf8"),
                 filePath: sourcePath
               };
             }, "resolveSource")
@@ -26740,9 +26820,17 @@ window.__FARM_MANIFEST__ = ${inlineValue({
             res.end(JSON.stringify({ error: "API route not found", pathname: pathname2 }));
             return;
           }
-          if (req.url?.startsWith("/@") || req.url?.startsWith("/node_modules") || requestPathname.includes(".") && !requestPathname.endsWith(".html")) {
+          if (req.url?.startsWith("/@") || req.url?.startsWith("/node_modules")) {
             return next();
           }
+          if (requestPathname.includes(".") && !requestPathname.endsWith(".html")) {
+            const matchesAppRoute = Boolean(
+              farmApp?.getRouteManager()?.matchRoute(requestPathname)?.route
+            );
+            if (!matchesAppRoute || devServableFileExists(requestPathname, [server.config.publicDir, server.config.root])) {
+              return next();
+            }
+          }
           if (req.url?.startsWith("/__farm/page-data")) {
             const urlObj = new URL(req.url, `http://${req.headers.host || "localhost:3000"}`);
             const targetPath = urlObj.searchParams.get("path") || "/";
@@ -27448,8 +27536,8 @@ if (import.meta.hot) {
         }
         logger.info(`Found ${ssgPages.length} SSG pages, ${ssrRoutes.length} SSR routes`);
         logger.info("Pre-rendering SSG pages...");
-        const outDir = path25.join(server?.config.root || process.cwd(), options.outDir || "dist");
-        const clientDir = path25.join(outDir, "client");
+        const outDir = path26.join(server?.config.root || process.cwd(), options.outDir || "dist");
+        const clientDir = path26.join(outDir, "client");
         for (const page2 of ssgPages) {
           try {
             const staticRequest = new Request(new URL(page2.urlPath, "http://farm.static"));
@@ -27501,9 +27589,9 @@ if (import.meta.hot) {
   <script type="module" src="/assets/client.js"></script>
 </body>
 </html>`;
-              const outputPath = page2.urlPath === "/" ? path25.join(clientDir, "index.html") : path25.join(clientDir, page2.urlPath + ".html");
-              fs7.mkdirSync(path25.dirname(outputPath), { recursive: true });
-              fs7.writeFileSync(outputPath, fullHtml);
+              const outputPath = page2.urlPath === "/" ? path26.join(clientDir, "index.html") : path26.join(clientDir, page2.urlPath + ".html");
+              fs8.mkdirSync(path26.dirname(outputPath), { recursive: true });
+              fs8.writeFileSync(outputPath, fullHtml);
               const revalidateInfo = page2.revalidate ? ` (revalidate: ${page2.revalidate}s)` : "";
               logger.success(`  \u2713 ${page2.urlPath}${revalidateInfo}`);
             });
@@ -27511,8 +27599,8 @@ if (import.meta.hot) {
             logger.error(`  \u2717 ${page2.urlPath}: ${error}`);
           }
         }
-        const manifestPath = path25.join(outDir, "__ssg_manifest.json");
-        fs7.writeFileSync(
+        const manifestPath = path26.join(outDir, "__ssg_manifest.json");
+        fs8.writeFileSync(
           manifestPath,
           JSON.stringify(
             ssgPages.map((p) => ({
@@ -27547,9 +27635,9 @@ if (import.meta.hot) {
       }
       const currentFarmConfig = farmApp?.getConfig();
       const normalizedFile = file.replace(/\\/g, "/");
-      const currentSrcRoot = currentFarmConfig ? getFarmSourceRoots(currentFarmConfig).map((source) => path25.join(source.root, source.srcDir).replace(/\\/g, "/")).find((sourceRoot) => normalizedFile.startsWith(`${sourceRoot}/`)) || null : null;
+      const currentSrcRoot = currentFarmConfig ? getFarmSourceRoots(currentFarmConfig).map((source) => path26.join(source.root, source.srcDir).replace(/\\/g, "/")).find((sourceRoot) => normalizedFile.startsWith(`${sourceRoot}/`)) || null : null;
       if (currentSrcRoot && normalizedFile.startsWith(`${currentSrcRoot}/`) && isProgrammaticRoutesFileName(normalizedFile)) {
-        logUpdate("PAGE", `updated ${path25.basename(file)}`);
+        logUpdate("PAGE", `updated ${path26.basename(file)}`);
         for (const mod of modules) {
           server2.moduleGraph.invalidateModule(mod);
         }
@@ -28735,6 +28823,19 @@ async function tryHydrateImportedPage(
     const PageComponent = pageModule?.default;
     if (!PageComponent) return false;
 
+    if (
+      typeof PageComponent === 'function' &&
+      PageComponent.constructor &&
+      PageComponent.constructor.name === 'AsyncFunction'
+    ) {
+      console.warn(
+        '[Farm.js] Skipping hydration for ' + modulePath +
+        ': async server components cannot run in the browser. ' +
+        'Server-rendered HTML is preserved; move interactive UI into a "use client" child of a synchronous page.'
+      );
+      return false;
+    }
+
     currentPageComponent = PageComponent;
     currentPageProps = await buildRouteComponentProps(
       pageModule,
@@ -29288,7 +29389,7 @@ function generateClientManifest(bundle) {
 __name(generateClientManifest, "generateClientManifest");
 async function defineConfig2(config = {}) {
   const tailwindcss = (await import("@tailwindcss/vite")).default;
-  const appRoot = path25.resolve(config.root || process.cwd());
+  const appRoot = path26.resolve(config.root || process.cwd());
   if (config.extends?.length) {
     const { config: layeredConfig } = await Promise.resolve().then(() => (init_layers(), layers_exports)).then(
       ({ resolveFarmLayers: resolveFarmLayers2 }) => resolveFarmLayers2(config, {