@modern-js/prod-server 2.5.1-alpha.2 → 2.6.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/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

@@ -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
 ));
@@ -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
 ));
@@ -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);
@@ -142,16 +172,14 @@ class Server {
   }
   initAppContext() {
     const { options } = this;
-    const { pwd: appDirectory, plugins = [], config, appContext } = options;
+    const { pwd: appDirectory, plugins = [], config } = options;
     const serverPlugins = plugins.map((p) => ({
       server: p
     }));
     return {
       appDirectory,
-      apiDirectory: appContext == null ? void 0 : appContext.apiDirectory,
-      lambdaDirectory: appContext == null ? void 0 : appContext.lambdaDirectory,
-      sharedDirectory: (appContext == null ? void 0 : appContext.sharedDirectory) || import_path.default.resolve(appDirectory, import_utils.SHARED_DIR),
       distDirectory: import_path.default.join(appDirectory, config.output.path || "dist"),
+      sharedDirectory: import_path.default.resolve(appDirectory, import_utils.SHARED_DIR),
       plugins: serverPlugins
     };
   }

package/dist/cjs/server/modern-server.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
 ));
@@ -72,6 +76,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;
@@ -119,6 +124,7 @@ class ModernServer {
     this.addHandler(this.routeHandler.bind(this));
     this.compose();
   }
+  // server ready
   onRepack(_) {
   }
   addBeforeRouteHandler() {
@@ -141,6 +147,7 @@ class ModernServer {
     const onlyWeb = filepath.startsWith(serverPath);
     this.prepareFrameHandler({ onlyWeb, onlyApi });
   }
+  // exposed requestHandler
   getRequestHandler() {
     return this.requestHandler.bind(this);
   }
@@ -162,6 +169,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 +182,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,6 +205,7 @@ class ModernServer {
     );
     this.beforeRouteHandler = handler;
   }
+  // gather frame extension and get framework handler
   async prepareFrameHandler(options) {
     const { workDir, runner } = this;
     const { onlyApi, onlyWeb } = options || {};
@@ -230,7 +243,6 @@ class ModernServer {
         pwd: workDir,
         config: extension,
         prefix: Array.isArray(prefix) ? prefix[0] : prefix,
-        httpMethodDecider: bff == null ? void 0 : bff.httpMethodDecider,
         render: this.render.bind(this)
       },
       { onLast: () => null }
@@ -263,6 +275,7 @@ class ModernServer {
   async proxy() {
     return null;
   }
+  // warmup ssr function
   warmupSSRBundle() {
     const { distDir } = this;
     const bundles = this.router.getBundles();
@@ -276,6 +289,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 +371,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 +391,7 @@ class ModernServer {
       afterRenderContext.template.prependHead(
         `<script>window._SERVER_DATA=${JSON.stringify(
           context.serverData
-        )}<\/script>`
+        )}</script>`
       );
       response = afterRenderContext.template.get();
     }
@@ -392,6 +407,7 @@ class ModernServer {
     }
     return false;
   }
+  // compose handlers and create the final handler
   compose() {
     const { handlers } = this;
     if (!Array.isArray(handlers)) {

package/dist/esm/libs/context/context.js

@@ -47,9 +47,15 @@ var ModernServerContext = /*#__PURE__*/ function() {
     "use strict";
     function ModernServerContext(req, res, options) {
         _classCallCheck(this, ModernServerContext);
-        _defineProperty(this, "req", void 0);
-        _defineProperty(this, "res", void 0);
-        _defineProperty(this, "params", {});
+        /**
+   * http request
+   */ _defineProperty(this, "req", void 0);
+        /**
+   * http response
+   */ _defineProperty(this, "res", void 0);
+        /**
+   * url params
+   */ _defineProperty(this, "params", {});
         _defineProperty(this, "serverData", void 0);
         _defineProperty(this, "options", {});
         this.req = req;
@@ -88,6 +94,7 @@ var ModernServerContext = /*#__PURE__*/ function() {
             }
         },
         {
+            // compat express res.send, only support etag now
             key: "send",
             value: function send(body) {
                 try {
@@ -155,7 +162,7 @@ var ModernServerContext = /*#__PURE__*/ function() {
         },
         {
             key: "headers",
-            get: function get() {
+            get: /* request property */ function get() {
                 return this.req.headers;
             }
         },
@@ -248,7 +255,7 @@ var ModernServerContext = /*#__PURE__*/ function() {
         },
         {
             key: "status",
-            get: function get() {
+            get: /* response property */ function get() {
                 return this.res.statusCode;
             },
             set: function set(statusCode) {
@@ -256,7 +263,9 @@ var ModernServerContext = /*#__PURE__*/ function() {
             }
         },
         {
-            key: "resHasHandled",
+            /**
+   * 判断链接是否已经关闭
+   */ key: "resHasHandled",
             value: function resHasHandled() {
                 return this.res.writableEnded;
             }

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

@@ -203,6 +203,7 @@ var CacheManager = /*#__PURE__*/ function() {
         this.cacheOptions = cacheOptions;
         this.cache = new LRUCache({
             max: Math.min(MAX_SIZE_EACH_CLUSTER, 600) * 1024 * 1024,
+            // 默认存 100M，最大 600M
             length: function length(n) {
                 var len = n.caches.keys().reduce(function(total, cur) {
                     var _n_caches_peek;