@modern-js/prod-server 2.5.1-alpha.3 → 2.6.1-alpha.0

package/CHANGELOG.md

@@ -1,5 +1,19 @@
 # @modern-js/prod-server
 
+## 2.6.0
+
+### Patch Changes
+
+- 36164a2: fix: env.PORT should be respected when using listenOptions
+  fix: 当使用 listenOptions 时，env.PORT 应该被支持
+- 49fa0b1: fix: remove header info from SSR ctx to avoid security issues, reserved a switch
+  fix: 移除 SSR 上下文中的 header 信息，避免造成安全问题，预留一个字段开启
+- Updated dependencies [e1f799e]
+- Updated dependencies [7915ab3]
+- Updated dependencies [0fe658a]
+  - @modern-js/utils@2.6.0
+  - @modern-js/server-core@2.6.0
+
 ## 2.5.0
 
 ### Patch Changes

package/dist/cjs/index.js

@@ -18,14 +18,14 @@ var __reExport = (target, mod, secondTarget) => (__copyProps(target, mod, "defau
 var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
 var src_exports = {};
 __export(src_exports, {
-  ModernServer: () => import_modern_server.ModernServer,
+  ModernServer: () => import_modernServer.ModernServer,
   Server: () => import_server.Server,
   createProxyHandler: () => import_proxy.createProxyHandler,
   default: () => src_default
 });
 module.exports = __toCommonJS(src_exports);
 var import_server = require("./server");
-var import_modern_server = require("./server/modern-server");
+var import_modernServer = require("./server/modernServer");
 var import_proxy = require("./libs/proxy");
 __reExport(src_exports, require("./type"), module.exports);
 __reExport(src_exports, require("./constants"), module.exports);

package/dist/cjs/libs/context/context.js

@@ -17,6 +17,10 @@ var __copyProps = (to, from, except, desc) => {
   return to;
 };
 var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
   isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
   mod
 ));
@@ -34,6 +38,9 @@ var import_fresh = __toESM(require("fresh"));
 var import_utils = require("../../utils");
 class ModernServerContext {
   constructor(req, res, options) {
+    /**
+     * url params
+     */
     this.params = {};
     this.options = {};
     this.req = req;
@@ -56,6 +63,7 @@ class ModernServerContext {
       this.send(body);
     };
   }
+  // compat express res.send, only support etag now
   send(body) {
     try {
       const generateETag = !this.res.getHeader("ETag") && this.options.etag;
@@ -105,6 +113,7 @@ class ModernServerContext {
     }
     return false;
   }
+  /* request property */
   get headers() {
     return this.req.headers;
   }
@@ -165,12 +174,16 @@ class ModernServerContext {
     const str = this.querystring;
     return import_querystring.default.parse(str);
   }
+  /* response property */
   get status() {
     return this.res.statusCode;
   }
   set status(statusCode) {
     this.res.statusCode = statusCode;
   }
+  /**
+   * 判断链接是否已经关闭
+   */
   resHasHandled() {
     return this.res.writableEnded;
   }

package/dist/cjs/libs/hook-api/index.js

@@ -17,6 +17,10 @@ var __copyProps = (to, from, except, desc) => {
   return to;
 };
 var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
   isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
   mod
 ));

package/dist/cjs/libs/loadConfig.js

@@ -17,6 +17,10 @@ var __copyProps = (to, from, except, desc) => {
   return to;
 };
 var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
   isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
   mod
 ));
@@ -53,6 +57,7 @@ const loadConfig = ({
       {
         ...resolvedConfig,
         plugins: []
+        // filter cli plugins
       },
       serverConfig,
       cliConfig

package/dist/cjs/libs/render/cache/__tests__/cache.fun.test.js

@@ -13,6 +13,10 @@ var __copyProps = (to, from, except, desc) => {
   return to;
 };
 var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
   isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
   mod
 ));

package/dist/cjs/libs/render/cache/page-caches/lru.js

@@ -17,6 +17,10 @@ var __copyProps = (to, from, except, desc) => {
   return to;
 };
 var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
   isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
   mod
 ));

package/dist/cjs/libs/render/cache/spr.js

@@ -17,6 +17,10 @@ var __copyProps = (to, from, except, desc) => {
   return to;
 };
 var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
   isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
   mod
 ));
@@ -75,6 +79,7 @@ class CacheManager {
     this.cacheOptions = cacheOptions;
     this.cache = new import_lru_cache.default({
       max: Math.min(MAX_SIZE_EACH_CLUSTER, 600) * 1024 * 1024,
+      // 默认存 100M，最大 600M
       length(n) {
         const len = n.caches.keys().reduce((total, cur) => {
           var _a;

package/dist/cjs/libs/render/cache/util.js

@@ -17,6 +17,10 @@ var __copyProps = (to, from, except, desc) => {
   return to;
 };
 var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
   isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
   mod
 ));

package/dist/cjs/libs/render/index.js

@@ -17,6 +17,10 @@ var __copyProps = (to, from, except, desc) => {
   return to;
 };
 var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
   isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
   mod
 ));

package/dist/cjs/libs/render/reader.js

@@ -17,6 +17,10 @@ var __copyProps = (to, from, except, desc) => {
   return to;
 };
 var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
   isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
   mod
 ));
@@ -44,11 +48,13 @@ const createCacheItem = async (filepath, mtime) => {
   };
 };
 class LruReader {
+  // private timer?: NodeJS.Timeout;
   constructor() {
     this.cache = new import_lru_cache.default({
       max: 256 * MB,
       length: getContentLength,
       maxAge: 5 * 60 * 5e3
+      // 60s
     });
   }
   init() {
@@ -93,6 +99,9 @@ class LruReader {
       }
     }
   }
+  // private timeTask() {
+  // this.timer = setInterval(() => this.update, 5 * 60 * 1000).unref();
+  // }
 }
 const reader = new LruReader();
 const readFile = async (filepath) => {

package/dist/cjs/libs/render/ssr.js

@@ -17,6 +17,10 @@ var __copyProps = (to, from, except, desc) => {
   return to;
 };
 var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
   isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
   mod
 ));
@@ -28,12 +32,19 @@ __export(ssr_exports, {
 module.exports = __toCommonJS(ssr_exports);
 var import_path = __toESM(require("path"));
 var import_utils = require("@modern-js/utils");
-var import_cookie = __toESM(require("cookie"));
 var import_cache = __toESM(require("./cache"));
 var import_measure = require("./measure");
 const render = async (ctx, renderOptions, runner) => {
   var _a;
-  const { urlPath, bundle, distDir, template, entryName, staticGenerate } = renderOptions;
+  const {
+    urlPath,
+    bundle,
+    distDir,
+    template,
+    entryName,
+    staticGenerate,
+    enableUnsafeCtx = false
+  } = renderOptions;
   const bundleJS = import_path.default.join(distDir, bundle);
   const loadableUri = import_path.default.join(distDir, import_utils.LOADABLE_STATS_FILE);
   const loadableStats = import_utils.fs.existsSync(loadableUri) ? require(loadableUri) : "";
@@ -47,7 +58,6 @@ const render = async (ctx, renderOptions, runner) => {
       host: ctx.host,
       query: ctx.query,
       url: ctx.href,
-      cookieMap: import_cookie.default.parse(ctx.headers.cookie || ""),
       headers: ctx.headers
     },
     response: {
@@ -63,12 +73,14 @@ const render = async (ctx, renderOptions, runner) => {
     template,
     loadableStats,
     routeManifest,
+    // for streaming ssr
     entryName,
     staticGenerate,
     logger: void 0,
     metrics: void 0,
     req: ctx.req,
-    res: ctx.res
+    res: ctx.res,
+    enableUnsafeCtx
   };
   context.logger = (0, import_measure.createLogger)(context, ctx.logger);
   context.metrics = (0, import_measure.createMetrics)(context, ctx.metrics);

package/dist/cjs/libs/render/static.js

@@ -17,6 +17,10 @@ var __copyProps = (to, from, except, desc) => {
   return to;
 };
 var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
   isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
   mod
 ));

package/dist/cjs/libs/route/index.js

@@ -27,6 +27,7 @@ class RouteMatchManager {
     this.specs = [];
     this.matchers = [];
   }
+  // get all routes matches pathname
   filter(pathname) {
     return this.matchers.reduce((matches, matcher) => {
       if (matcher.matchUrlPath(pathname)) {
@@ -35,6 +36,7 @@ class RouteMatchManager {
       return matches;
     }, []);
   }
+  // get best match from a set of matches
   best(pathname, matches) {
     let best;
     let matchedLen = 0;
@@ -50,6 +52,7 @@ class RouteMatchManager {
     }
     return best;
   }
+  // reset routes matcher
   reset(specs) {
     this.specs = specs;
     const matchers = specs.reduce((ms, spec) => {
@@ -58,6 +61,7 @@ class RouteMatchManager {
     }, []);
     this.matchers = matchers;
   }
+  // get best match from all matcher in manager
   match(pathname) {
     const matches = this.filter(pathname);
     const best = this.best(pathname, matches);

package/dist/cjs/libs/route/matcher.js

@@ -40,6 +40,7 @@ class RouteMatcher {
     this.spec = spec;
     this.setupUrlPath();
   }
+  // generate modern route object
   generate(url) {
     const route = new import_route.ModernRoute(this.spec);
     if (this.urlPath) {
@@ -57,6 +58,7 @@ class RouteMatcher {
       return matchResult.params;
     }
   }
+  // get match url length
   matchLength(pathname) {
     var _a;
     if (!this.urlReg) {
@@ -66,6 +68,7 @@ class RouteMatcher {
       return ((_a = result == null ? void 0 : result[0]) == null ? void 0 : _a.length) || null;
     }
   }
+  // if match url path
   matchUrlPath(requestUrl) {
     let urlWithoutSlash = requestUrl.endsWith("/") && requestUrl !== "/" ? requestUrl.slice(0, -1) : requestUrl;
     urlWithoutSlash = removeHtmlSuffix(urlWithoutSlash);
@@ -85,6 +88,7 @@ class RouteMatcher {
   matchEntry(entryName) {
     return this.spec.entryName === entryName;
   }
+  // compiler urlPath to regexp if necessary
   setupUrlPath() {
     const { urlPath } = this.spec;
     this.urlPath = urlPath === "/" ? urlPath : removeTailSlash(urlPath);

package/dist/cjs/libs/{serve-file.js → serveFile.js}

@@ -17,16 +17,20 @@ var __copyProps = (to, from, except, desc) => {
   return to;
 };
 var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
   isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
   mod
 ));
 var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
-var serve_file_exports = {};
-__export(serve_file_exports, {
+var serveFile_exports = {};
+__export(serveFile_exports, {
   createStaticFileHandler: () => createStaticFileHandler,
   faviconFallbackHandler: () => faviconFallbackHandler
 });
-module.exports = __toCommonJS(serve_file_exports);
+module.exports = __toCommonJS(serveFile_exports);
 var import_serve_static = __toESM(require("serve-static"));
 var import_utils = require("@modern-js/utils");
 var import_utils2 = require("../utils");
@@ -49,27 +53,30 @@ const faviconFallbackHandler = (context, next) => {
     next();
   }
 };
-const createStaticFileHandler = (rules, output = {}) => async (context, next) => {
-  const { url: requestUrl, req, res } = context;
-  const { assetPrefix = "/" } = output;
-  const hitRule = rules.find((item) => {
-    if ((0, import_utils.isString)(item.path) && requestUrl.startsWith(item.path)) {
-      return true;
-    } else if ((0, import_utils.isRegExp)(item.path) && item.path.test(requestUrl)) {
-      return true;
-    }
-    return false;
-  });
-  if (hitRule) {
-    const resume = removedPrefix(req, assetPrefix);
-    (0, import_serve_static.default)(hitRule.target)(req, res, () => {
-      resume();
-      next();
+const createStaticFileHandler = (rules, output = {}) => (
+  // eslint-disable-next-line consistent-return
+  async (context, next) => {
+    const { url: requestUrl, req, res } = context;
+    const { assetPrefix = "/" } = output;
+    const hitRule = rules.find((item) => {
+      if ((0, import_utils.isString)(item.path) && requestUrl.startsWith(item.path)) {
+        return true;
+      } else if ((0, import_utils.isRegExp)(item.path) && item.path.test(requestUrl)) {
+        return true;
+      }
+      return false;
     });
-  } else {
-    return next();
+    if (hitRule) {
+      const resume = removedPrefix(req, assetPrefix);
+      (0, import_serve_static.default)(hitRule.target)(req, res, () => {
+        resume();
+        next();
+      });
+    } else {
+      return next();
+    }
   }
-};
+);
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   createStaticFileHandler,

package/dist/cjs/server/index.js

@@ -17,6 +17,10 @@ var __copyProps = (to, from, except, desc) => {
   return to;
 };
 var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
   isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
   mod
 ));
@@ -33,10 +37,10 @@ var import_server_core = require("@modern-js/server-core");
 var import_metrics = require("../libs/metrics");
 var import_loadConfig = require("../libs/loadConfig");
 var import_utils2 = require("../utils");
-var import_modern_server_split = require("./modern-server-split");
+var import_modernServerSplit = require("./modernServerSplit");
 class Server {
   constructor(options) {
-    this.serverImpl = import_modern_server_split.createProdServer;
+    this.serverImpl = import_modernServerSplit.createProdServer;
     options.logger = options.logger || new import_utils.Logger({
       level: "warn"
     });
@@ -44,6 +48,20 @@ class Server {
     this.options = options;
     this.serverConfig = {};
   }
+  /**
+   * 初始化顺序
+   * - 读取 .env.{process.env.MODERN_ENV} 文件，加载环境变量
+   * - 获取 server runtime config
+   * - 设置 context
+   * - 创建 hooksRunner
+   * - 合并插件，内置插件和 serverConfig 中配置的插件
+   * - 执行 config hook
+   * - 获取最终的配置
+   * - 设置配置到 context
+   * - 初始化 server
+   * - 执行 prepare hook
+   * - 执行 server init
+   */
   async init() {
     const { options } = this;
     this.loadServerEnv(options);
@@ -58,6 +76,11 @@ class Server {
     await this.server.onInit(this.runner, this.app);
     return this;
   }
+  /**
+   * Execute config hooks
+   * @param runner
+   * @param options
+   */
   runConfigHook(runner, serverConfig) {
     const newServerConfig = runner.config(serverConfig || {});
     return newServerConfig;
@@ -75,6 +98,10 @@ class Server {
     const serverConfig = (0, import_loadConfig.requireConfig)(serverConfigPath);
     this.serverConfig = serverConfig;
   }
+  /**
+   *
+   * merge cliConfig and serverConfig
+   */
   async initConfig(runner, options) {
     const { pwd, config } = options;
     const { serverConfig } = this;
@@ -98,6 +125,9 @@ class Server {
       listener == null ? void 0 : listener();
     };
     if (typeof options === "object") {
+      if (process.env.PORT) {
+        Object.assign(options, { port: process.env.PORT });
+      }
       this.app.listen(options, callback);
     } else {
       this.app.listen(process.env.PORT || options || 8080, callback);

package/dist/cjs/server/{modern-server.js → modernServer.js}

@@ -17,21 +17,25 @@ var __copyProps = (to, from, except, desc) => {
   return to;
 };
 var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
   isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
   mod
 ));
 var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
-var modern_server_exports = {};
-__export(modern_server_exports, {
+var modernServer_exports = {};
+__export(modernServer_exports, {
   ModernServer: () => ModernServer
 });
-module.exports = __toCommonJS(modern_server_exports);
+module.exports = __toCommonJS(modernServer_exports);
 var import_http = require("http");
 var import_path = __toESM(require("path"));
 var import_utils = require("@modern-js/utils");
 var import_route = require("../libs/route");
 var import_render = require("../libs/render");
-var import_serve_file = require("../libs/serve-file");
+var import_serveFile = require("../libs/serveFile");
 var import_utils2 = require("../utils");
 var reader = __toESM(require("../libs/render/reader"));
 var import_proxy = require("../libs/proxy");
@@ -39,7 +43,6 @@ var import_context = require("../libs/context");
 var import_template = require("../libs/hook-api/template");
 var import_constants = require("../constants");
 var import_hook_api = require("../libs/hook-api");
-const API_DIR = "./api";
 const SERVER_DIR = "./server";
 class ModernServer {
   constructor({
@@ -72,6 +75,7 @@ class ModernServer {
     this.staticGenerate = staticGenerate || false;
     this.runMode = runMode || import_constants.RUN_MODE.FULL;
   }
+  // server prepare
   async onInit(runner, app) {
     var _a, _b;
     this.runner = runner;
@@ -96,7 +100,7 @@ class ModernServer {
       this.conf.output || {},
       this.conf.html
     );
-    this.staticFileHandler = (0, import_serve_file.createStaticFileHandler)(
+    this.staticFileHandler = (0, import_serveFile.createStaticFileHandler)(
       [
         {
           path: staticPathRegExp,
@@ -114,11 +118,12 @@ class ModernServer {
     });
     await this.setupBeforeProdMiddleware();
     this.addHandler(this.staticFileHandler);
-    this.addHandler(import_serve_file.faviconFallbackHandler);
+    this.addHandler(import_serveFile.faviconFallbackHandler);
     this.addBeforeRouteHandler();
     this.addHandler(this.routeHandler.bind(this));
     this.compose();
   }
+  // server ready
   onRepack(_) {
   }
   addBeforeRouteHandler() {
@@ -141,6 +146,7 @@ class ModernServer {
     const onlyWeb = filepath.startsWith(serverPath);
     this.prepareFrameHandler({ onlyWeb, onlyApi });
   }
+  // exposed requestHandler
   getRequestHandler() {
     return this.requestHandler.bind(this);
   }
@@ -162,6 +168,8 @@ class ModernServer {
   async createHTTPServer(handler) {
     return (0, import_http.createServer)(handler);
   }
+  /* —————————————————————— function will be overwrite —————————————————————— */
+  // get routes info
   getRoutes() {
     if (this.presetRoutes) {
       return this.presetRoutes;
@@ -173,9 +181,12 @@ class ModernServer {
     }
     return [];
   }
+  // add promisify request handler to server
+  // handler should do not do more things after invoke next
   addHandler(handler) {
     this.handlers.push(handler);
   }
+  // return 404 page
   render404(context) {
     context.error(import_constants.ERROR_DIGEST.ENOTF, "404 Not Found");
     this.renderErrorPage(context, 404);
@@ -193,19 +204,19 @@ class ModernServer {
     );
     this.beforeRouteHandler = handler;
   }
+  // gather frame extension and get framework handler
   async prepareFrameHandler(options) {
     const { workDir, runner } = this;
     const { onlyApi, onlyWeb } = options || {};
     const { getMiddlewares, ...collector } = (0, import_utils2.createMiddlewareCollecter)();
     await runner.gather(collector);
     const { api: pluginAPIExt, web: pluginWebExt } = getMiddlewares();
-    const apiDir = import_path.default.join(workDir, API_DIR);
     const serverDir = import_path.default.join(workDir, SERVER_DIR);
     if (await import_utils.fs.pathExists(import_path.default.join(serverDir)) && !onlyApi) {
       const webExtension = (0, import_utils2.mergeExtension)(pluginWebExt);
       this.frameWebHandler = await this.prepareWebHandler(webExtension);
     }
-    if (import_utils.fs.existsSync(apiDir) && !onlyWeb) {
+    if (!onlyWeb) {
       const apiExtension = (0, import_utils2.mergeExtension)(pluginAPIExt);
       this.frameAPIHandler = await this.prepareAPIHandler(apiExtension);
     }
@@ -263,6 +274,7 @@ class ModernServer {
   async proxy() {
     return null;
   }
+  // warmup ssr function
   warmupSSRBundle() {
     const { distDir } = this;
     const bundles = this.router.getBundles();
@@ -276,6 +288,8 @@ class ModernServer {
   createContext(req, res, options = {}) {
     return (0, import_context.createContext)(req, res, options);
   }
+  /* —————————————————————— private function —————————————————————— */
+  // handler route.json, include api / csr / ssr
   async routeHandler(context) {
     const { res } = context;
     const matched = this.router.match(context.path);
@@ -356,7 +370,7 @@ class ModernServer {
         (0, import_template.templateInjectableStream)({
           prependHead: route.entryName ? `<script>window._SERVER_DATA=${JSON.stringify(
             context.serverData
-          )}<\/script>` : void 0
+          )}</script>` : void 0
         })
       ).pipe(res);
       return;
@@ -376,7 +390,7 @@ class ModernServer {
       afterRenderContext.template.prependHead(
         `<script>window._SERVER_DATA=${JSON.stringify(
           context.serverData
-        )}<\/script>`
+        )}</script>`
       );
       response = afterRenderContext.template.get();
     }
@@ -392,6 +406,7 @@ class ModernServer {
     }
     return false;
   }
+  // compose handlers and create the final handler
   compose() {
     const { handlers } = this;
     if (!Array.isArray(handlers)) {