mock-service-cli 4.5.0 → 4.6.0

package/README.md

@@ -76,8 +76,9 @@ npx mock-service-cli [options] [path]
 | `-D` 或 `--web-dir`        | 启用 Web 服务器，指定 web 目录（SPA 应用）                        | -      |
 | `-P` 或 `--web-port`       | Web 服务器端口                                                    | 9090   |
 | `-b` 或 `--web-baseurl`    | 指定 SPA Web 服务器的公共路径                                     | -      |
-| `-R` 或 `--static-server`  | 启用静态服务器，指定静态资源目录                                  | -      |
-| `--static-config <file>`   | 静态服务器的 JSON 配置：热更新、HTTPS、挂载、代理与 SPA 回退      | -      |
+| `-R` 或 `--static-server`  | 启用单目录静态服务器，指定静态资源目录                            | -      |
+| `--spa-fallback <path>`    | 单目录模式显式启用 SPA 回退                                       | -      |
+| `--static-config <file>`   | 使用自包含 JSON 配置启动静态服务器                                | -      |
 | `-w` 或 `--open`           | 自动打开 API 概览页、文件浏览器页                                 | false  |
 | `-e` 或 `--explorer`       | 启用文件浏览器服务器，指定要浏览的目录                            | ./     |
 | `--edit`                   | 启用文件浏览器的新建、重命名、删除和上传操作                      | false  |
@@ -108,16 +109,21 @@ mock-service-cli -f ./mock.js
 # 启动静态服务器
 mock-service-cli -R ./public
 
-# 使用 Live Server 风格的热更新配置
-mock-service-cli -R ./public --static-config ./static-server.json
+# 单目录模式启用 SPA 回退
+mock-service-cli -R ./public --spa-fallback /index.html
+
+# 使用自包含配置（不需要目录参数）
+mock-service-cli -R --static-config ./static-server.json
+mock-service-cli --static-config ./static-server.json
 ```
 
 静态服务器会监听资源变化并向 HTML 页面注入热更新客户端：CSS 文件更新时替换样式表，其余变更刷新页面。
 默认不打开浏览器；在配置中设置 `"open": true` 或提供页面路径即可打开。完整配置字段和示例见
 [`docs/static-server.config.example.json`](./docs/static-server.config.example.json)：支持忽略规则、SPA 回退、挂载目录、代理、HTTPS、CORS、响应头和自定义浏览器命令。
-`-p`、`--host`、`-A` 和 `--proxy-options` 仍可使用，且同名 CLI 配置优先。
-未设置 `spaFallback` 时，根目录和子目录会显示可点击的目录索引，不会自动加载 `index.html`；用户可直接访问该文件。
-只有显式设置 `"spaFallback": "/index.html"`（或其他入口）时，未命中的路由才会返回 SPA 入口页。
+配置文件只在顶层保留服务器级字段。所有应用都放在 `mounts` 中，并可独立设置 `directory`、`spaFallback`、`proxy`、`cors`、`headers` 和 `secure`。mount 未设置 `path` 时默认挂载到 `/`；`directory` 可省略，但该应用必须配置至少一条代理。代理键使用完整公开路径，例如 `/api/app`。
+代理规则使用 `{ "target": "http://...", "rewrite": true }`；`rewrite` 为 true 时只移除匹配的完整代理前缀并保留剩余路径和 query string。应用级 `secure` 控制其代理 HTTPS 目标的证书校验，默认 `false`。配置模式不接受 `--proxy-options`、`--rewrite` 或 `--spa-fallback`。
+未设置 `spaFallback` 时，应用目录会显示可点击的目录索引；可直接访问其中的 HTML 文件。mount 未命中的路由不会继续进入其他应用的 SPA fallback。
+设置了 `spaFallback` 的应用可选配置 `accessLog.success` 与 `accessLog.failure` 文件路径。服务将把每次访问以 JSON Lines 写入对应文件：2xx/3xx 写入 success，4xx/5xx 写入 failure；路径相对配置文件解析。启动后控制台会突出显示每条代理所属的应用、公开前缀、目标和 rewrite 状态。
 
 ### Web 服务器 (SPA)
 

package/dist/file-explorer-login.html

@@ -4,7 +4,7 @@
     <meta charset="UTF-8" />
     <meta name="viewport" content="width=device-width, initial-scale=1.0" />
     <title>文件浏览器登录</title>
-    <link rel="icon" type="image/svg+xml" href="/favicon-file-explorer-login.svg" />
+    <link rel="icon" type="image/svg+xml" href="__FILE_EXPLORER_FAVICON_URL__" />
     <style>
       * { box-sizing: border-box; }
       body { margin: 0; min-height: 100vh; display: grid; place-items: center; background: #f4f6f8; color: #202124; font-family: -apple-system, BlinkMacSystemFont, "Segoe UI", sans-serif; }

package/dist/file-explorer.html

@@ -4,7 +4,7 @@
     <meta charset="UTF-8" />
     <meta name="viewport" content="width=device-width, initial-scale=1.0" />
     <title>文件浏览器 - File Explorer</title>
-    <link rel="icon" type="image/svg+xml" href="/favicon-file-explorer.svg" />
+    <link rel="icon" type="image/svg+xml" href="__FILE_EXPLORER_FAVICON_URL__" />
     <style>
       * {
         margin: 0;
@@ -1158,6 +1158,7 @@
       let explorerLifecycleVersion = 0;
       let currentArchiveJobId = null;
       let currentArchiveJobOperation = null;
+      let explorerRootId = null;
       let archiveCapabilities = { createFormats: [], readExtensions: [] };
 
       const EXPLORER_AUTH_STORAGE_KEY = 'mock-service-cli.file-explorer.password';
@@ -1281,6 +1282,7 @@
           const config = await response.json();
           if (!response.ok || config.error) throw new Error(config.error || 'Failed to load configuration');
           editMode = Boolean(config.editMode);
+          explorerRootId = typeof config.rootId === 'string' ? config.rootId : null;
         } catch (error) {
           console.warn('Failed to load file explorer configuration:', error);
           editMode = false;
@@ -1413,7 +1415,25 @@
         }
       }
 
-      async function initializeExplorer(isPageRestore = false) {
+      function getStoredExplorerPath() {
+        try {
+          const stored = JSON.parse(sessionStorage.getItem(EXPLORER_PATH_STORAGE_KEY));
+          if (stored && stored.rootId === explorerRootId && typeof stored.path === 'string' && stored.path.startsWith('/')) {
+            return stored.path;
+          }
+        } catch (error) {
+          // Earlier releases stored the path directly; discard that unscoped value.
+        }
+        sessionStorage.removeItem(EXPLORER_PATH_STORAGE_KEY);
+        return '/';
+      }
+
+      function storeExplorerPath(path) {
+        if (!explorerRootId) return;
+        sessionStorage.setItem(EXPLORER_PATH_STORAGE_KEY, JSON.stringify({ rootId: explorerRootId, path }));
+      }
+
+      async function initializeExplorer() {
         if (explorerInitializationPromise) return explorerInitializationPromise;
 
         const lifecycleVersion = explorerLifecycleVersion;
@@ -1443,7 +1463,7 @@
           await loadArchiveCapabilities();
           if (lifecycleVersion !== explorerLifecycleVersion) return;
           startHealthCheck();
-          await loadDirectory(isPageRestore ? currentPath : sessionStorage.getItem(EXPLORER_PATH_STORAGE_KEY) || '/');
+          await loadDirectory(getStoredExplorerPath(), { fallbackToRoot: true });
         })();
         explorerInitializationPromise = initializationPromise;
 
@@ -1460,7 +1480,7 @@
 
       window.addEventListener('pagehide', handlePageHide);
       window.addEventListener('pageshow', event => {
-        if (event.persisted) initializeExplorer(true);
+        if (event.persisted) initializeExplorer();
       });
 
       function showContextMenu(x, y, filePath, isDirectory) {
@@ -1538,7 +1558,7 @@
         hideContextMenu();
       }
 
-      async function loadDirectory(path) {
+      async function loadDirectory(path, { fallbackToRoot = false } = {}) {
         const fileGrid = document.getElementById('fileGrid');
         const oldCurrentPath = currentPath;
         const requestId = ++directoryRequestId;
@@ -1562,12 +1582,14 @@
           const data = await response.json();
 
           if (!response.ok || data.error) {
-            throw new Error(data.error);
+            const error = new Error(data.error || 'Failed to load directory');
+            error.status = response.status;
+            throw error;
           }
           if (requestId !== directoryRequestId) return;
 
           currentPath = data.currentPath;
-          sessionStorage.setItem(EXPLORER_PATH_STORAGE_KEY, currentPath);
+          storeExplorerPath(currentPath);
           allFiles = data.files || [];
 
           if (document.getElementById('searchInput')) {
@@ -1580,6 +1602,10 @@
           updateBackButton(data.parentPath);
         } catch (error) {
           if (error.name === 'AbortError' || requestId !== directoryRequestId) return;
+          if (fallbackToRoot && path !== '/' && error.status === 404) {
+            sessionStorage.removeItem(EXPLORER_PATH_STORAGE_KEY);
+            return loadDirectory('/', { fallbackToRoot: false });
+          }
           console.error('Error loading directory:', error);
           currentPath = oldCurrentPath;
           const parentPath = currentPath === '/' ? null : currentPath.substring(0, currentPath.lastIndexOf('/')) || '/';

package/dist/meta.json

@@ -1088,7 +1088,7 @@
       "format": "cjs"
     },
     "src/bin/mock-service-cli": {
-      "bytes": 12219,
+      "bytes": 13264,
       "imports": [
         {
           "path": "node_modules/colors/safe.js",
@@ -6704,7 +6704,7 @@
       "format": "cjs"
     },
     "src/lib/staticServer.js": {
-      "bytes": 23163,
+      "bytes": 33699,
       "imports": [
         {
           "path": "node_modules/express/index.js",
@@ -7484,7 +7484,7 @@
       "format": "cjs"
     },
     "src/lib/fileExplorerServer.js": {
-      "bytes": 25074,
+      "bytes": 25537,
       "imports": [
         {
           "path": "node_modules/express/index.js",
@@ -8872,7 +8872,7 @@
           "bytesInOutput": 429
         },
         "src/bin/mock-service-cli": {
-          "bytesInOutput": 9280
+          "bytesInOutput": 10204
         },
         "node_modules/depd/index.js": {
           "bytesInOutput": 6779
@@ -9856,7 +9856,7 @@
           "bytesInOutput": 10974
         },
         "src/lib/staticServer.js": {
-          "bytesInOutput": 18312
+          "bytesInOutput": 26622
         },
         "node_modules/busboy/lib/utils.js": {
           "bytesInOutput": 8707
@@ -9979,13 +9979,13 @@
           "bytesInOutput": 7774
         },
         "src/lib/fileExplorerServer.js": {
-          "bytesInOutput": 18585
+          "bytesInOutput": 19066
         },
         "src/runtime.js": {
           "bytesInOutput": 507
         }
       },
-      "bytes": 1621515
+      "bytes": 1631230
     }
   }
 }