@faapi/faapi 0.0.0-canary.f5b23c6 → 1.0.0-canary.3a00f3e

package/dist/index.js

@@ -1043,6 +1043,87 @@ async function loadConfig(rootDir, dist) {
   return null;
 }
 
+// src/cli/loadEnv.ts
+import fs2 from "fs";
+import path3 from "path";
+function resolveEnv() {
+  return process.env.NODE_ENV || "development";
+}
+function getEnvFiles(env) {
+  return [".env", ".env.local", `.env.${env}`, `.env.${env}.local`];
+}
+function parseEnvFile(content, fileVars) {
+  const result = {};
+  const lines = content.replace(/\r\n/g, "\n").split("\n");
+  for (const line of lines) {
+    const trimmed = line.trim();
+    if (!trimmed || trimmed.startsWith("#")) continue;
+    const match = /^(?:export\s+)?([A-Za-z_][A-Za-z0-9_]*)\s*=\s*(.*)$/.exec(trimmed);
+    if (!match) continue;
+    const [, key, rawValue] = match;
+    const value = parseValue(rawValue, { ...fileVars, ...result });
+    result[key] = value;
+  }
+  return result;
+}
+function parseValue(raw, env) {
+  if (raw === "") return "";
+  if (raw[0] === "'") {
+    const end = raw.indexOf("'", 1);
+    return end === -1 ? raw.slice(1) : raw.slice(1, end);
+  }
+  if (raw[0] === '"') {
+    const match = /^"((?:\\.|[^"\\])*)"/.exec(raw);
+    const inner = match ? match[1] : raw.slice(1);
+    return expandEscapesAndVars(inner, env);
+  }
+  const commentMatch = /^(.*?)(\s+#.*)$/.exec(raw);
+  const value = commentMatch ? commentMatch[1] : raw;
+  return value.trim();
+}
+function expandEscapesAndVars(str, env) {
+  const escaped = str.replace(/\\(.)/g, (_, ch) => {
+    switch (ch) {
+      case "n":
+        return "\n";
+      case "r":
+        return "\r";
+      case "t":
+        return "	";
+      case "\\":
+        return "\\";
+      case '"':
+        return '"';
+      default:
+        return ch;
+    }
+  });
+  return escaped.replace(
+    /\$\{([A-Za-z_][A-Za-z0-9_]*)\}|\$([A-Za-z_][A-Za-z0-9_]*)/g,
+    (_, braced, plain) => {
+      const varName = braced || plain;
+      return env[varName] ?? process.env[varName] ?? "";
+    }
+  );
+}
+function loadEnv(rootDir) {
+  const env = resolveEnv();
+  const files = getEnvFiles(env);
+  const merged = {};
+  for (const file of files) {
+    const filePath = path3.join(rootDir, file);
+    if (!fs2.existsSync(filePath)) continue;
+    const content = fs2.readFileSync(filePath, "utf-8");
+    const parsed = parseEnvFile(content, merged);
+    Object.assign(merged, parsed);
+  }
+  for (const [key, value] of Object.entries(merged)) {
+    if (process.env[key] === void 0) {
+      process.env[key] = value;
+    }
+  }
+}
+
 // src/errors/FaapiError.ts
 var FaapiError = class extends Error {
   constructor(code, message, statusCode) {
@@ -1069,14 +1150,14 @@ var ValidationError = class extends FaapiError {
   issues;
 };
 var RouteNotFoundError = class extends FaapiError {
-  constructor(path9) {
-    super("ROUTE_NOT_FOUND", `Route not found: ${path9}`, 404);
+  constructor(path10) {
+    super("ROUTE_NOT_FOUND", `Route not found: ${path10}`, 404);
     this.name = "RouteNotFoundError";
   }
 };
 var MethodNotAllowedError = class extends FaapiError {
-  constructor(method, path9, allowedMethods) {
-    super("METHOD_NOT_ALLOWED", `Method ${method} not allowed for ${path9}`, 405);
+  constructor(method, path10, allowedMethods) {
+    super("METHOD_NOT_ALLOWED", `Method ${method} not allowed for ${path10}`, 405);
     this.allowedMethods = allowedMethods;
     this.name = "MethodNotAllowedError";
   }
@@ -1095,182 +1176,6 @@ var ModuleLoadError = class extends FaapiError {
   }
 };
 
-// src/cli/createAppCore.ts
-import fs4 from "fs";
-import path7 from "path";
-import { PassThrough } from "stream";
-
-// src/router/sortRoutes.ts
-function sortRoutes(routes) {
-  return [...routes].sort((a, b) => {
-    if (a.isDynamic !== b.isDynamic) {
-      return a.isDynamic ? 1 : -1;
-    }
-    if (a.isCatchAll !== b.isCatchAll) {
-      return a.isCatchAll ? 1 : -1;
-    }
-    const aSegments = a.urlPath.split("/").filter(Boolean).length;
-    const bSegments = b.urlPath.split("/").filter(Boolean).length;
-    if (aSegments !== bSegments) {
-      return aSegments - bSegments;
-    }
-    return a.urlPath.localeCompare(b.urlPath);
-  });
-}
-
-// src/router/detectRouteConflicts.ts
-function detectRouteConflicts(routes) {
-  const map = /* @__PURE__ */ new Map();
-  for (const route of routes) {
-    const key = `${route.method} ${route.urlPath}`;
-    const existing = map.get(key);
-    if (existing) {
-      existing.files.push(route.filePath);
-    } else {
-      map.set(key, {
-        method: route.method,
-        urlPath: route.urlPath,
-        files: [route.filePath]
-      });
-    }
-  }
-  const conflicts = [];
-  for (const conflict of map.values()) {
-    if (conflict.files.length > 1) {
-      conflicts.push(conflict);
-    }
-  }
-  return conflicts;
-}
-
-// src/server/createServer.ts
-import {
-  createServer as createHttpServer
-} from "http";
-import { createSecureServer as createHttp2SecureServer } from "http2";
-import { readFileSync } from "fs";
-import { Readable as Readable2 } from "stream";
-import path5 from "path";
-
-// src/router/matchRoute.ts
-function matchRoute(routes, method, path9) {
-  for (const route of routes) {
-    if (route.method !== method) {
-      continue;
-    }
-    if (!route.isDynamic) {
-      if (route.urlPath === path9) {
-        return { route, params: {} };
-      }
-      continue;
-    }
-    const params = matchDynamicPath(route.urlPath, path9, route.paramNames, route.isCatchAll);
-    if (params !== null) {
-      return { route, params };
-    }
-  }
-  return null;
-}
-function matchWsRoute(wsRoutes, path9) {
-  for (const route of wsRoutes) {
-    if (!route.isDynamic) {
-      if (route.urlPath === path9) {
-        return { route, params: {} };
-      }
-      continue;
-    }
-    const params = matchDynamicPath(route.urlPath, path9, route.paramNames, route.isCatchAll);
-    if (params !== null) {
-      return { route, params };
-    }
-  }
-  return null;
-}
-function matchDynamicPath(pattern, path9, paramNames, isCatchAll) {
-  const patternSegments = pattern.split("/").filter(Boolean);
-  const pathSegments = path9.split("/").filter(Boolean);
-  if (isCatchAll) {
-    const nonCatchAllCount = patternSegments.length - 1;
-    if (pathSegments.length <= nonCatchAllCount) {
-      return null;
-    }
-    const params2 = {};
-    for (let i = 0; i < nonCatchAllCount; i++) {
-      const patternSeg = patternSegments[i];
-      const pathSeg = pathSegments[i];
-      if (patternSeg.startsWith(":")) {
-        const paramName = patternSeg.slice(1);
-        params2[paramName] = pathSeg;
-      } else if (patternSeg !== pathSeg) {
-        return null;
-      }
-    }
-    const catchAllValue = pathSegments.slice(nonCatchAllCount).join("/");
-    const catchAllParamName = patternSegments[nonCatchAllCount].slice(4);
-    params2[catchAllParamName] = catchAllValue;
-    if (Object.keys(params2).length !== paramNames.length) {
-      return null;
-    }
-    return params2;
-  }
-  if (patternSegments.length !== pathSegments.length) {
-    return null;
-  }
-  const params = {};
-  for (let i = 0; i < patternSegments.length; i++) {
-    const patternSeg = patternSegments[i];
-    const pathSeg = pathSegments[i];
-    if (patternSeg.startsWith(":")) {
-      const paramName = patternSeg.slice(1);
-      params[paramName] = pathSeg;
-    } else if (patternSeg !== pathSeg) {
-      return null;
-    }
-  }
-  if (Object.keys(params).length !== paramNames.length) {
-    return null;
-  }
-  return params;
-}
-
-// src/loader/resolveExports.ts
-function resolveExport(module, exportName) {
-  if (exportName in module && typeof module[exportName] !== "undefined") {
-    return module[exportName];
-  }
-  const defaultExport = module.default;
-  if (defaultExport !== null && typeof defaultExport === "object") {
-    const value = defaultExport[exportName];
-    if (value !== void 0) {
-      return value;
-    }
-  }
-  return void 0;
-}
-
-// src/loader/validateRouteModule.ts
-function validateRouteModule(value, method, filePath) {
-  if (typeof value !== "function") {
-    throw new Error(
-      `Route module "${filePath}" does not export a valid handler for method "${method}". Expected a function, got ${typeof value}.`
-    );
-  }
-}
-
-// src/loader/loadRouteModule.ts
-async function loadRouteModule(filePath, method) {
-  let module;
-  try {
-    module = await importWithCacheBust(filePath);
-  } catch (err) {
-    const reason = err instanceof Error ? err.message : String(err);
-    throw new Error(`Failed to load route module "${filePath}": ${reason}`, { cause: err });
-  }
-  const handler = resolveExport(module, method);
-  validateRouteModule(handler, method, filePath);
-  return { handler, method };
-}
-
 // src/runtime/sse.ts
 function encodeSseEvent(event) {
   let out = "";
@@ -1337,6 +1242,11 @@ function createSseWriter() {
       const text = encodeSseEvent(event);
       controller.enqueue(encoder.encode(text));
     },
+    sendRaw(chunk) {
+      if (closed || !controller) return;
+      const bytes = typeof chunk === "string" ? encoder.encode(chunk) : chunk;
+      controller.enqueue(bytes);
+    },
     sendError(error) {
       if (closed || !controller) return;
       const message = error instanceof Error ? error.message : String(error);
@@ -1475,13 +1385,429 @@ function createContext(request, params, config = {}, ip = "") {
   return ctx;
 }
 
-// src/utils/queryToObject.ts
-function queryToObject(params) {
-  const result = {};
-  for (const [key, value] of params) {
-    result[key] = value;
+// src/utils/isPlainObject.ts
+function isPlainObject(value) {
+  if (value === null || typeof value !== "object") {
+    return false;
+  }
+  if (Array.isArray(value)) {
+    return false;
+  }
+  const proto = Object.getPrototypeOf(value);
+  return proto === null || proto === Object.prototype;
+}
+
+// src/response/toResponse.ts
+async function toResponse(value, meta) {
+  if (value instanceof Promise) {
+    return toResponse(await value, meta);
+  }
+  const applyMeta = (headers2) => {
+    if (!meta) return;
+    for (const [key, val] of Object.entries(meta.headers)) {
+      headers2.set(key, val);
+    }
+    for (const cookie of meta.setCookies ?? []) {
+      headers2.append("set-cookie", cookie);
+    }
+  };
+  if (value instanceof Response) {
+    if (meta && (meta.status !== void 0 || Object.keys(meta.headers).length > 0 || meta.setCookies.length > 0)) {
+      const headers2 = new Headers(value.headers);
+      applyMeta(headers2);
+      return new Response(value.body, {
+        status: meta.status ?? value.status,
+        headers: headers2
+      });
+    }
+    return value;
+  }
+  if (value === null || value === void 0) {
+    const status = meta?.status ?? 204;
+    const headers2 = new Headers();
+    applyMeta(headers2);
+    return new Response(null, { status, headers: headers2 });
+  }
+  if (typeof ReadableStream !== "undefined" && value instanceof ReadableStream) {
+    const headers2 = new Headers({ "Content-Type": "application/octet-stream" });
+    applyMeta(headers2);
+    return new Response(value, {
+      status: meta?.status ?? 200,
+      headers: headers2
+    });
+  }
+  if (typeof Buffer !== "undefined" && Buffer.isBuffer(value)) {
+    const headers2 = new Headers({ "Content-Type": "application/octet-stream" });
+    applyMeta(headers2);
+    return new Response(value, {
+      status: meta?.status ?? 200,
+      headers: headers2
+    });
+  }
+  if (value instanceof Uint8Array) {
+    const headers2 = new Headers({ "Content-Type": "application/octet-stream" });
+    applyMeta(headers2);
+    return new Response(value, {
+      status: meta?.status ?? 200,
+      headers: headers2
+    });
+  }
+  if (isPlainObject(value) || Array.isArray(value)) {
+    const body2 = JSON.stringify(value);
+    const headers2 = new Headers({ "Content-Type": "application/json" });
+    applyMeta(headers2);
+    return new Response(body2, {
+      status: meta?.status ?? 200,
+      headers: headers2
+    });
+  }
+  if (typeof value === "string") {
+    const headers2 = new Headers({ "Content-Type": "text/plain" });
+    applyMeta(headers2);
+    return new Response(value, {
+      status: meta?.status ?? 200,
+      headers: headers2
+    });
+  }
+  if (typeof value === "number" || typeof value === "boolean") {
+    const headers2 = new Headers({ "Content-Type": "text/plain" });
+    applyMeta(headers2);
+    return new Response(String(value), {
+      status: meta?.status ?? 200,
+      headers: headers2
+    });
+  }
+  const body = JSON.stringify(value);
+  const headers = new Headers({ "Content-Type": "application/json" });
+  applyMeta(headers);
+  return new Response(body, {
+    status: meta?.status ?? 200,
+    headers
+  });
+}
+
+// src/utils/queryToObject.ts
+function queryToObject(params) {
+  const result = {};
+  for (const [key, value] of params) {
+    result[key] = value;
+  }
+  return result;
+}
+
+// src/injection/injectParams.ts
+function getBuiltinInjectionValue(type, ctx, body) {
+  switch (type) {
+    case "query":
+      return queryToObject(ctx.query);
+    case "params":
+      return ctx.params;
+    case "headers":
+      return ctx.headers;
+    case "context":
+      return ctx;
+    case "cookies":
+      return ctx.cookies;
+    case "ip":
+      return ctx.ip;
+    case "body":
+      return body;
+    // form 与 body 共享解析结果（resolveInput 已按 Content-Type 解析 form-urlencoded）
+    // 差异仅在 schema 校验（form coerce=true，由 collectRouteSchemaSources 标记）
+    case "form":
+      return body;
+    case "files":
+      if (body && typeof body === "object" && "files" in body) {
+        return body.files;
+      }
+      return [];
+    case "fields":
+      if (body && typeof body === "object" && "fields" in body) {
+        return body.fields;
+      }
+      return {};
+    default:
+      return void 0;
+  }
+}
+async function injectParamsAsync(handler, ctx, body, injectors) {
+  const injections = resolveInjection(handler);
+  if (injections.length === 0) {
+    return await handler();
+  }
+  const args = await Promise.all(
+    injections.map(async (injection) => {
+      if (injection.type !== "unknown") {
+        return getBuiltinInjectionValue(injection.type, ctx, body);
+      }
+      if (injectors && injection.name in injectors) {
+        return await injectors[injection.name](ctx);
+      }
+      return void 0;
+    })
+  );
+  return await handler(...args);
+}
+
+// src/runtime/invokeHandler.ts
+function mergeMeta(response, meta) {
+  const hasMeta = meta.status !== void 0 || Object.keys(meta.headers).length > 0 || meta.setCookies.length > 0;
+  if (!hasMeta) return response;
+  const headers = new Headers(response.headers);
+  for (const [key, value] of Object.entries(meta.headers)) {
+    headers.set(key, value);
+  }
+  for (const cookie of meta.setCookies) {
+    headers.append("set-cookie", cookie);
+  }
+  return new Response(response.body, {
+    status: meta.status ?? response.status,
+    headers
+  });
+}
+async function compose(middlewares, ctx, finalHandler) {
+  const meta = ctx.meta;
+  let index = -1;
+  async function dispatch(i) {
+    if (i <= index) {
+      throw new Error("next() called multiple times");
+    }
+    index = i;
+    if (i >= middlewares.length) {
+      return await finalHandler();
+    }
+    const mw = middlewares[i];
+    let innerResponse;
+    const next = async () => {
+      innerResponse = await dispatch(i + 1);
+      return innerResponse;
+    };
+    const result = await mw(ctx, next);
+    if (result instanceof Response) {
+      return mergeMeta(result, meta);
+    }
+    if (innerResponse !== void 0) {
+      return innerResponse;
+    }
+    throw new Error("\u4E2D\u95F4\u4EF6\u5FC5\u987B await next() \u6216\u8FD4\u56DE Response");
+  }
+  return await dispatch(0);
+}
+async function invokeHandler(handler, ctx, body, middlewares, injectors) {
+  const meta = ctx.meta;
+  const pickSseAndAutoClose = () => {
+    const sseWriter = ctx.__sseWriter;
+    if (!sseWriter) return null;
+    if (!sseWriter.closed && !sseWriter.aborted) {
+      sseWriter.close();
+    }
+    return mergeMeta(sseWriter.response, meta);
+  };
+  const autoCloseSseOnError = () => {
+    const sseWriter = ctx.__sseWriter;
+    if (sseWriter && !sseWriter.closed && !sseWriter.aborted) {
+      sseWriter.close();
+    }
+  };
+  if (!middlewares || middlewares.length === 0) {
+    try {
+      const result = await injectParamsAsync(handler, ctx, body, injectors);
+      const sseResponse = pickSseAndAutoClose();
+      if (sseResponse) return sseResponse;
+      return toResponse(result, meta);
+    } catch (err) {
+      autoCloseSseOnError();
+      throw err;
+    }
+  }
+  const finalHandler = async () => {
+    try {
+      const result = await injectParamsAsync(handler, ctx, body, injectors);
+      const sseResponse = pickSseAndAutoClose();
+      if (sseResponse) return sseResponse;
+      return toResponse(result, meta);
+    } catch (err) {
+      autoCloseSseOnError();
+      throw err;
+    }
+  };
+  return await compose(middlewares, ctx, finalHandler);
+}
+
+// src/cli/createAppCore.ts
+import fs5 from "fs";
+import path8 from "path";
+import { PassThrough } from "stream";
+
+// src/router/sortRoutes.ts
+function sortRoutes(routes) {
+  return [...routes].sort((a, b) => {
+    if (a.isDynamic !== b.isDynamic) {
+      return a.isDynamic ? 1 : -1;
+    }
+    if (a.isCatchAll !== b.isCatchAll) {
+      return a.isCatchAll ? 1 : -1;
+    }
+    const aSegments = a.urlPath.split("/").filter(Boolean).length;
+    const bSegments = b.urlPath.split("/").filter(Boolean).length;
+    if (aSegments !== bSegments) {
+      return aSegments - bSegments;
+    }
+    return a.urlPath.localeCompare(b.urlPath);
+  });
+}
+
+// src/router/detectRouteConflicts.ts
+function detectRouteConflicts(routes) {
+  const map = /* @__PURE__ */ new Map();
+  for (const route of routes) {
+    const key = `${route.method} ${route.urlPath}`;
+    const existing = map.get(key);
+    if (existing) {
+      existing.files.push(route.filePath);
+    } else {
+      map.set(key, {
+        method: route.method,
+        urlPath: route.urlPath,
+        files: [route.filePath]
+      });
+    }
+  }
+  const conflicts = [];
+  for (const conflict of map.values()) {
+    if (conflict.files.length > 1) {
+      conflicts.push(conflict);
+    }
+  }
+  return conflicts;
+}
+
+// src/server/createServer.ts
+import {
+  createServer as createHttpServer
+} from "http";
+import { createSecureServer as createHttp2SecureServer } from "http2";
+import { readFileSync } from "fs";
+import { Readable as Readable2 } from "stream";
+import path6 from "path";
+
+// src/router/matchRoute.ts
+function matchRoute(routes, method, path10) {
+  for (const route of routes) {
+    if (route.method !== method) {
+      continue;
+    }
+    if (!route.isDynamic) {
+      if (route.urlPath === path10) {
+        return { route, params: {} };
+      }
+      continue;
+    }
+    const params = matchDynamicPath(route.urlPath, path10, route.paramNames, route.isCatchAll);
+    if (params !== null) {
+      return { route, params };
+    }
+  }
+  return null;
+}
+function matchWsRoute(wsRoutes, path10) {
+  for (const route of wsRoutes) {
+    if (!route.isDynamic) {
+      if (route.urlPath === path10) {
+        return { route, params: {} };
+      }
+      continue;
+    }
+    const params = matchDynamicPath(route.urlPath, path10, route.paramNames, route.isCatchAll);
+    if (params !== null) {
+      return { route, params };
+    }
+  }
+  return null;
+}
+function matchDynamicPath(pattern, path10, paramNames, isCatchAll) {
+  const patternSegments = pattern.split("/").filter(Boolean);
+  const pathSegments = path10.split("/").filter(Boolean);
+  if (isCatchAll) {
+    const nonCatchAllCount = patternSegments.length - 1;
+    if (pathSegments.length <= nonCatchAllCount) {
+      return null;
+    }
+    const params2 = {};
+    for (let i = 0; i < nonCatchAllCount; i++) {
+      const patternSeg = patternSegments[i];
+      const pathSeg = pathSegments[i];
+      if (patternSeg.startsWith(":")) {
+        const paramName = patternSeg.slice(1);
+        params2[paramName] = pathSeg;
+      } else if (patternSeg !== pathSeg) {
+        return null;
+      }
+    }
+    const catchAllValue = pathSegments.slice(nonCatchAllCount).join("/");
+    const catchAllParamName = patternSegments[nonCatchAllCount].slice(4);
+    params2[catchAllParamName] = catchAllValue;
+    if (Object.keys(params2).length !== paramNames.length) {
+      return null;
+    }
+    return params2;
+  }
+  if (patternSegments.length !== pathSegments.length) {
+    return null;
+  }
+  const params = {};
+  for (let i = 0; i < patternSegments.length; i++) {
+    const patternSeg = patternSegments[i];
+    const pathSeg = pathSegments[i];
+    if (patternSeg.startsWith(":")) {
+      const paramName = patternSeg.slice(1);
+      params[paramName] = pathSeg;
+    } else if (patternSeg !== pathSeg) {
+      return null;
+    }
+  }
+  if (Object.keys(params).length !== paramNames.length) {
+    return null;
+  }
+  return params;
+}
+
+// src/loader/resolveExports.ts
+function resolveExport(module, exportName) {
+  if (exportName in module && typeof module[exportName] !== "undefined") {
+    return module[exportName];
+  }
+  const defaultExport = module.default;
+  if (defaultExport !== null && typeof defaultExport === "object") {
+    const value = defaultExport[exportName];
+    if (value !== void 0) {
+      return value;
+    }
+  }
+  return void 0;
+}
+
+// src/loader/validateRouteModule.ts
+function validateRouteModule(value, method, filePath) {
+  if (typeof value !== "function") {
+    throw new Error(
+      `Route module "${filePath}" does not export a valid handler for method "${method}". Expected a function, got ${typeof value}.`
+    );
+  }
+}
+
+// src/loader/loadRouteModule.ts
+async function loadRouteModule(filePath, method) {
+  let module;
+  try {
+    module = await importWithCacheBust(filePath);
+  } catch (err) {
+    const reason = err instanceof Error ? err.message : String(err);
+    throw new Error(`Failed to load route module "${filePath}": ${reason}`, { cause: err });
   }
-  return result;
+  const handler = resolveExport(module, method);
+  validateRouteModule(handler, method, filePath);
+  return { handler, method };
 }
 
 // src/utils/parseJsonBody.ts
@@ -1564,246 +1890,6 @@ async function resolveInput(method, request) {
   return queryToObject(url.searchParams);
 }
 
-// src/utils/isPlainObject.ts
-function isPlainObject(value) {
-  if (value === null || typeof value !== "object") {
-    return false;
-  }
-  if (Array.isArray(value)) {
-    return false;
-  }
-  const proto = Object.getPrototypeOf(value);
-  return proto === null || proto === Object.prototype;
-}
-
-// src/response/toResponse.ts
-async function toResponse(value, meta) {
-  if (value instanceof Promise) {
-    return toResponse(await value, meta);
-  }
-  const applyMeta = (headers2) => {
-    if (!meta) return;
-    for (const [key, val] of Object.entries(meta.headers)) {
-      headers2.set(key, val);
-    }
-    for (const cookie of meta.setCookies ?? []) {
-      headers2.append("set-cookie", cookie);
-    }
-  };
-  if (value instanceof Response) {
-    if (meta && (meta.status !== void 0 || Object.keys(meta.headers).length > 0 || meta.setCookies.length > 0)) {
-      const headers2 = new Headers(value.headers);
-      applyMeta(headers2);
-      return new Response(value.body, {
-        status: meta.status ?? value.status,
-        headers: headers2
-      });
-    }
-    return value;
-  }
-  if (value === null || value === void 0) {
-    const status = meta?.status ?? 204;
-    const headers2 = new Headers();
-    applyMeta(headers2);
-    return new Response(null, { status, headers: headers2 });
-  }
-  if (typeof ReadableStream !== "undefined" && value instanceof ReadableStream) {
-    const headers2 = new Headers({ "Content-Type": "application/octet-stream" });
-    applyMeta(headers2);
-    return new Response(value, {
-      status: meta?.status ?? 200,
-      headers: headers2
-    });
-  }
-  if (typeof Buffer !== "undefined" && Buffer.isBuffer(value)) {
-    const headers2 = new Headers({ "Content-Type": "application/octet-stream" });
-    applyMeta(headers2);
-    return new Response(value, {
-      status: meta?.status ?? 200,
-      headers: headers2
-    });
-  }
-  if (value instanceof Uint8Array) {
-    const headers2 = new Headers({ "Content-Type": "application/octet-stream" });
-    applyMeta(headers2);
-    return new Response(value, {
-      status: meta?.status ?? 200,
-      headers: headers2
-    });
-  }
-  if (isPlainObject(value) || Array.isArray(value)) {
-    const body2 = JSON.stringify(value);
-    const headers2 = new Headers({ "Content-Type": "application/json" });
-    applyMeta(headers2);
-    return new Response(body2, {
-      status: meta?.status ?? 200,
-      headers: headers2
-    });
-  }
-  if (typeof value === "string") {
-    const headers2 = new Headers({ "Content-Type": "text/plain" });
-    applyMeta(headers2);
-    return new Response(value, {
-      status: meta?.status ?? 200,
-      headers: headers2
-    });
-  }
-  if (typeof value === "number" || typeof value === "boolean") {
-    const headers2 = new Headers({ "Content-Type": "text/plain" });
-    applyMeta(headers2);
-    return new Response(String(value), {
-      status: meta?.status ?? 200,
-      headers: headers2
-    });
-  }
-  const body = JSON.stringify(value);
-  const headers = new Headers({ "Content-Type": "application/json" });
-  applyMeta(headers);
-  return new Response(body, {
-    status: meta?.status ?? 200,
-    headers
-  });
-}
-
-// src/injection/injectParams.ts
-function getBuiltinInjectionValue(type, ctx, body) {
-  switch (type) {
-    case "query":
-      return queryToObject(ctx.query);
-    case "params":
-      return ctx.params;
-    case "headers":
-      return ctx.headers;
-    case "context":
-      return ctx;
-    case "cookies":
-      return ctx.cookies;
-    case "ip":
-      return ctx.ip;
-    case "body":
-      return body;
-    // form 与 body 共享解析结果（resolveInput 已按 Content-Type 解析 form-urlencoded）
-    // 差异仅在 schema 校验（form coerce=true，由 collectRouteSchemaSources 标记）
-    case "form":
-      return body;
-    case "files":
-      if (body && typeof body === "object" && "files" in body) {
-        return body.files;
-      }
-      return [];
-    case "fields":
-      if (body && typeof body === "object" && "fields" in body) {
-        return body.fields;
-      }
-      return {};
-    default:
-      return void 0;
-  }
-}
-async function injectParamsAsync(handler, ctx, body, injectors) {
-  const injections = resolveInjection(handler);
-  if (injections.length === 0) {
-    return await handler();
-  }
-  const args = await Promise.all(
-    injections.map(async (injection) => {
-      if (injection.type !== "unknown") {
-        return getBuiltinInjectionValue(injection.type, ctx, body);
-      }
-      if (injectors && injection.name in injectors) {
-        return await injectors[injection.name](ctx);
-      }
-      return void 0;
-    })
-  );
-  return await handler(...args);
-}
-
-// src/runtime/invokeHandler.ts
-function mergeMeta(response, meta) {
-  const hasMeta = meta.status !== void 0 || Object.keys(meta.headers).length > 0 || meta.setCookies.length > 0;
-  if (!hasMeta) return response;
-  const headers = new Headers(response.headers);
-  for (const [key, value] of Object.entries(meta.headers)) {
-    headers.set(key, value);
-  }
-  for (const cookie of meta.setCookies) {
-    headers.append("set-cookie", cookie);
-  }
-  return new Response(response.body, {
-    status: meta.status ?? response.status,
-    headers
-  });
-}
-async function compose(middlewares, ctx, finalHandler) {
-  const meta = ctx.meta;
-  let index = -1;
-  async function dispatch(i) {
-    if (i <= index) {
-      throw new Error("next() called multiple times");
-    }
-    index = i;
-    if (i >= middlewares.length) {
-      return await finalHandler();
-    }
-    const mw = middlewares[i];
-    let innerResponse;
-    const next = async () => {
-      innerResponse = await dispatch(i + 1);
-      return innerResponse;
-    };
-    const result = await mw(ctx, next);
-    if (result instanceof Response) {
-      return mergeMeta(result, meta);
-    }
-    if (innerResponse !== void 0) {
-      return innerResponse;
-    }
-    throw new Error("\u4E2D\u95F4\u4EF6\u5FC5\u987B await next() \u6216\u8FD4\u56DE Response");
-  }
-  return await dispatch(0);
-}
-async function invokeHandler(handler, ctx, body, middlewares, injectors) {
-  const meta = ctx.meta;
-  const pickSseAndAutoClose = () => {
-    const sseWriter = ctx.__sseWriter;
-    if (!sseWriter) return null;
-    if (!sseWriter.closed && !sseWriter.aborted) {
-      sseWriter.close();
-    }
-    return mergeMeta(sseWriter.response, meta);
-  };
-  const autoCloseSseOnError = () => {
-    const sseWriter = ctx.__sseWriter;
-    if (sseWriter && !sseWriter.closed && !sseWriter.aborted) {
-      sseWriter.close();
-    }
-  };
-  if (!middlewares || middlewares.length === 0) {
-    try {
-      const result = await injectParamsAsync(handler, ctx, body, injectors);
-      const sseResponse = pickSseAndAutoClose();
-      if (sseResponse) return sseResponse;
-      return toResponse(result, meta);
-    } catch (err) {
-      autoCloseSseOnError();
-      throw err;
-    }
-  }
-  const finalHandler = async () => {
-    try {
-      const result = await injectParamsAsync(handler, ctx, body, injectors);
-      const sseResponse = pickSseAndAutoClose();
-      if (sseResponse) return sseResponse;
-      return toResponse(result, meta);
-    } catch (err) {
-      autoCloseSseOnError();
-      throw err;
-    }
-  };
-  return await compose(middlewares, ctx, finalHandler);
-}
-
 // src/response/sendNodeResponse.ts
 import { Readable } from "stream";
 async function sendNodeResponse(response, res) {
@@ -1872,9 +1958,9 @@ async function validateInput(schemaPath, method, inputType, input) {
 function mapZodIssues(error) {
   return error.issues.map((issue) => {
     const code = mapZodCode(issue.code, issue.message);
-    const path9 = issue.path.map(String).join(".") || "";
+    const path10 = issue.path.map(String).join(".") || "";
     return {
-      path: path9,
+      path: path10,
       code,
       expected: issue.expected ?? mapExpectedFromMessage(issue.message),
       received: issue.received ?? mapReceivedFromMessage(issue.message),
@@ -1934,7 +2020,7 @@ function getClientIp(req) {
 
 // src/server/handleWsUpgrade.ts
 import { WebSocketServer, WebSocket } from "ws";
-import path3 from "path";
+import path4 from "path";
 
 // src/errors/formatErrorResponse.ts
 function formatErrorResponse(error) {
@@ -2107,7 +2193,7 @@ function attachWebSocket(options) {
     const finalHandler = async () => {
       let handlers;
       try {
-        const absoluteFilePath = path3.resolve(rootDir, route.filePath);
+        const absoluteFilePath = path4.resolve(rootDir, route.filePath);
         handlers = await loadWsHandler(absoluteFilePath, ctx);
       } catch (err) {
         const reason = err instanceof Error ? err.message : String(err);
@@ -2153,8 +2239,8 @@ function attachWebSocket(options) {
 }
 
 // src/cli/generateSchemaFiles.ts
-import path4 from "path";
-import fs2 from "fs/promises";
+import path5 from "path";
+import fs3 from "fs/promises";
 
 // src/ast/generateZodSchema.ts
 var CodeGenContext = class {
@@ -2463,7 +2549,7 @@ function getSchemaOutputPath(sourceFile, dist, rootDir) {
   }
   const idx = rel.lastIndexOf("/");
   const relDir = idx >= 0 ? rel.slice(0, idx) : "";
-  return path4.resolve(rootDir, dist, relDir, "zod.js");
+  return path5.resolve(rootDir, dist, relDir, "zod.js");
 }
 function getRuntimeSchemaPath(filePath, dist, rootDir) {
   let rel = filePath.replace(/\\/g, "/");
@@ -2474,7 +2560,7 @@ function getRuntimeSchemaPath(filePath, dist, rootDir) {
   }
   const idx = rel.lastIndexOf("/");
   const relDir = idx >= 0 ? rel.slice(0, idx) : "";
-  return path4.resolve(rootDir, dist, relDir, "zod.js");
+  return path5.resolve(rootDir, dist, relDir, "zod.js");
 }
 function getHelpersImportPath(relDir) {
   if (!relDir) return `./${HELPERS_FILENAME}`;
@@ -2524,7 +2610,7 @@ async function generateSchemaFiles(routes, rootDir, dist) {
   }
   const fileEntries = [];
   for (const [filePath, fileSources] of sourcesByFile) {
-    const relFile = path4.relative(rootDir, filePath).replace(/\\/g, "/");
+    const relFile = path5.relative(rootDir, filePath).replace(/\\/g, "/");
     const outputPath = getSchemaOutputPath(relFile, dist, rootDir);
     const allTypes = allTypesByFile.get(filePath) ?? /* @__PURE__ */ new Map();
     let relForDir = relFile;
@@ -2539,7 +2625,7 @@ async function generateSchemaFiles(routes, rootDir, dist) {
   }
   const allSourceCode = fileEntries.map((e) => e.source).join("\n");
   if (usesCoerceHelpers(allSourceCode)) {
-    const helpersPath = path4.resolve(rootDir, dist, HELPERS_FILENAME);
+    const helpersPath = path5.resolve(rootDir, dist, HELPERS_FILENAME);
     await writeSchemaFile(helpersPath, generateHelpersFileSource());
   }
   await Promise.all(
@@ -2547,8 +2633,8 @@ async function generateSchemaFiles(routes, rootDir, dist) {
   );
 }
 async function writeSchemaFile(outputPath, source) {
-  await fs2.mkdir(path4.dirname(outputPath), { recursive: true });
-  await fs2.writeFile(outputPath, source, "utf-8");
+  await fs3.mkdir(path5.dirname(outputPath), { recursive: true });
+  await fs3.writeFile(outputPath, source, "utf-8");
 }
 
 // src/server/createServer.ts
@@ -2596,15 +2682,15 @@ function limitStreamSize(stream, maxSize) {
     }
   });
 }
-function findAllowedMethods(routes, path9) {
+function findAllowedMethods(routes, path10) {
   const methods = /* @__PURE__ */ new Set();
   for (const route of routes) {
-    if (route.urlPath === path9) {
+    if (route.urlPath === path10) {
       methods.add(route.method);
       continue;
     }
     if (route.isDynamic) {
-      const params = matchDynamicPath(route.urlPath, path9, route.paramNames, route.isCatchAll);
+      const params = matchDynamicPath(route.urlPath, path10, route.paramNames, route.isCatchAll);
       if (params !== null) {
         methods.add(route.method);
       }
@@ -2690,7 +2776,7 @@ async function handleRequest(routes, rootDir, dist, req, res, configMiddlewares,
     }
     ctx.params = match.params;
     const { route } = match;
-    const absoluteFilePath = path5.resolve(rootDir, route.filePath);
+    const absoluteFilePath = path6.resolve(rootDir, route.filePath);
     const routeModule = await loadRouteModule(absoluteFilePath, route.method);
     const input = await resolveInput(route.method, request);
     const inputType = getInputTypeForMethod(route.method);
@@ -2764,8 +2850,8 @@ function applyPluginWrappers(server, handlerWrappers, upgradeWrappers) {
 }
 
 // src/cli/generateRoutes.ts
-import fs3 from "fs";
-import path6 from "path";
+import fs4 from "fs";
+import path7 from "path";
 
 // src/middleware/loadMiddlewares.ts
 var middlewareCache = /* @__PURE__ */ new Map();
@@ -2921,7 +3007,7 @@ function resolveDeclaration(decl) {
 }
 
 // src/cli/createAppCore.ts
-var DEFAULT_DIST = ".faapi/build";
+var DEFAULT_DIST = "dist";
 var DEFAULT_PORT = 3e3;
 var ROUTES_FILE = "faapi-routes.js";
 var PATTERNS = ["src/api/**/*.ts"];
@@ -2943,8 +3029,8 @@ function isFaapiConfigKey(key) {
 async function createAppBase(options) {
   const rootDir = options?.rootDir ?? process.cwd();
   const dist = options?.dist ?? process.env.FAAPI_DIST ?? DEFAULT_DIST;
-  const routesPath = path7.resolve(rootDir, dist, ROUTES_FILE);
-  if (!fs4.existsSync(routesPath)) {
+  const routesPath = path8.resolve(rootDir, dist, ROUTES_FILE);
+  if (!fs5.existsSync(routesPath)) {
     throw new Error(
       `[faapi] ${dist}/${ROUTES_FILE} \u4E0D\u5B58\u5728\uFF0C\u8BF7\u5148\u6267\u884C \`faapi build\`\uFF08\u6216 \`faapi dev\`\uFF09\u751F\u6210\u4EA7\u7269\u3002`
     );
@@ -3147,8 +3233,8 @@ async function createAppBase(options) {
 
 // src/router/scanRoutes.ts
 import fg from "fast-glob";
-import path8 from "path";
-import fs5 from "fs";
+import path9 from "path";
+import fs6 from "fs";
 
 // src/router/constants.ts
 var HTTP_METHODS = ["GET", "POST", "PUT", "PATCH", "DELETE", "HEAD", "OPTIONS"];
@@ -3158,9 +3244,9 @@ function isHttpMethod(value) {
 }
 
 // src/utils/normalizePath.ts
-function normalizePath(path9) {
-  if (!path9) return "";
-  let result = path9.replace(/\\/g, "/");
+function normalizePath(path10) {
+  if (!path10) return "";
+  let result = path10.replace(/\\/g, "/");
   result = result.replace(/\/+/g, "/");
   result = result.replace(/\/+$/, "");
   if (result && !result.startsWith("/")) {
@@ -3209,38 +3295,38 @@ function filePathToUrlPath(filePath) {
 // src/router/scanRoutes.ts
 var APP_DIR = "src";
 function toProdAbsPath(sourceAbsPath, rootDir, dist) {
-  let rel = path8.relative(rootDir, sourceAbsPath).replace(/\\/g, "/");
+  let rel = path9.relative(rootDir, sourceAbsPath).replace(/\\/g, "/");
   if (rel.startsWith(`${APP_DIR}/`)) {
     rel = rel.slice(APP_DIR.length + 1);
   }
   const prodRel = `${dist}/${rel.replace(/\.ts$/, ".js")}`;
-  return path8.resolve(rootDir, prodRel);
+  return path9.resolve(rootDir, prodRel);
 }
 async function findMergedMiddlewares(routeFilePath, rootDir, dist) {
-  const routeDir = path8.dirname(routeFilePath);
-  const resolvedRoot = path8.resolve(rootDir);
+  const routeDir = path9.dirname(routeFilePath);
+  const resolvedRoot = path9.resolve(rootDir);
   const mwPaths = [];
-  let currentDir = path8.resolve(rootDir, routeDir);
+  let currentDir = path9.resolve(rootDir, routeDir);
   while (true) {
     if (dist) {
-      const mwPath = path8.join(currentDir, "middlewares.js");
-      const absMwPath = path8.resolve(rootDir, mwPath);
+      const mwPath = path9.join(currentDir, "middlewares.js");
+      const absMwPath = path9.resolve(rootDir, mwPath);
       const prodAbsMwPath = toProdAbsPath(absMwPath, rootDir, dist);
-      if (fs5.existsSync(prodAbsMwPath)) {
+      if (fs6.existsSync(prodAbsMwPath)) {
         mwPaths.push(prodAbsMwPath);
       }
     } else {
       for (const ext of [".ts", ".js"]) {
-        const mwPath = path8.join(currentDir, `middlewares${ext}`);
-        const absMwPath = path8.resolve(rootDir, mwPath);
-        if (fs5.existsSync(absMwPath)) {
+        const mwPath = path9.join(currentDir, `middlewares${ext}`);
+        const absMwPath = path9.resolve(rootDir, mwPath);
+        if (fs6.existsSync(absMwPath)) {
           mwPaths.push(absMwPath);
           break;
         }
       }
     }
     if (currentDir === resolvedRoot) break;
-    const parentDir = path8.dirname(currentDir);
+    const parentDir = path9.dirname(currentDir);
     if (parentDir === currentDir) break;
     currentDir = parentDir;
   }
@@ -3302,7 +3388,7 @@ async function scanRoutes(rootDir, patterns, dist) {
     const normalizedFile = file.replace(/\\/g, "/");
     const fileName = normalizedFile.split("/").pop();
     if (fileName === "handler.ts" || fileName === "handler.js") {
-      const absPath = path8.resolve(rootDir, normalizedFile);
+      const absPath = path9.resolve(rootDir, normalizedFile);
       const importPath = dist ? toProdAbsPath(absPath, rootDir, dist) : absPath;
       const urlPath = filePathToUrlPath(normalizedFile);
       const paramNames = extractParamNames(urlPath);
@@ -3373,6 +3459,7 @@ export {
   collectRouteSchemaSources,
   cors,
   createProdApp as createApp,
+  createContext,
   createDevApp,
   createProdApp,
   createProgram,
@@ -3380,7 +3467,9 @@ export {
   getInputTypeForMethod,
   helmet,
   invalidateProgramCache,
+  invokeHandler,
   loadConfig,
+  loadEnv,
   logger,
   resolveTypeNode
 };