@tbox.cn/app-template-h5 0.1.9 → 0.1.11

package/README.md

@@ -35,7 +35,7 @@ pnpm install
 | `PORT` | server | 服务端口（默认 8000） |
 | `HOST` | server | 监听地址（默认 0.0.0.0） |
 | `VITE_API_URL` | client | API base（空串/未设 = 同源相对路径）；经 `configureRuntime` 注入 |
-| `TBOX_DEV_TOKEN` | server | 沙箱 dev server 鉴权 token（方案 W；平台运行时注入，**本地无需设置**）：形状 `^[A-Za-z0-9_-]{20,128}$`。在场 → protected 双面裁决——dev 面（凭据 + 浏览器导航/同源信号）完整 vite 能力，static 面（无凭据/跨源子资源）纯 dist + SSE 刷新（`GET /__tbox_dev_hot_reload`），零源码泄漏；缺席 → classic（与历史行为字节级等价）。形状不合规 → fail-closed 全 static |
+| `TBOX_DEV_TOKEN` | server | 沙箱 dev server 鉴权 token（方案 W；平台运行时注入，**本地无需设置**）：形状 `^[A-Za-z0-9_-]{20,128}$`。在场 → protected 双面裁决——dev 面（凭据 + 浏览器导航/同源信号）完整 vite 能力，static 面（无凭据/跨源子资源）dist 静态 + SPA fallback catch-all（GET/HEAD 未命中恒回入口页，对齐生产）+ SSE 刷新（`GET /__tbox_dev_hot_reload`），零源码泄漏；缺席 → classic（与历史行为字节级等价）。形状不合规 → fail-closed 全 static |
 | `TBOX_DEV_SSE_KEEPALIVE_MS` | server | protected 面 SSE 心跳间隔 ms（缺省 15000；smoke 覆盖用） |
 
 ## 验收

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tbox.cn/app-template-h5",
-  "version": "0.1.9",
+  "version": "0.1.11",
   "description": "tbox 移动 H5 全栈模板（单 workspace：apps/client + apps/server），运行时与页面微调经 @tbox.cn/app-sdk。",
   "type": "module",
   "engines": {
@@ -35,7 +35,7 @@
     "eslint-plugin-react-hooks": "5.2.0",
     "typescript-eslint": "8.67.0",
     "vite": "6.4.3",
-    "@tbox.cn/app-sdk-server": "0.23.0"
+    "@tbox.cn/app-sdk-server": "0.24.1"
   },
   "scripts": {
     "dev": "pnpm --filter ./apps/server dev",

package/pnpm-lock.template.yaml

@@ -7,11 +7,11 @@ settings:
 catalogs:
   default:
     '@tbox.cn/app-sdk-client':
-      specifier: 0.21.1
-      version: 0.21.1
+      specifier: 0.21.2
+      version: 0.21.2
     '@tbox.cn/app-sdk-server':
-      specifier: 0.23.0
-      version: 0.23.0
+      specifier: 0.24.1
+      version: 0.24.1
     '@types/express':
       specifier: 4.17.25
       version: 4.17.25
@@ -82,7 +82,7 @@ importers:
     devDependencies:
       '@tbox.cn/app-sdk-server':
         specifier: 'catalog:'
-        version: 0.23.0
+        version: 0.24.1
       eslint:
         specifier: 'catalog:'
         version: 9.39.5
@@ -100,7 +100,7 @@ importers:
     dependencies:
       '@tbox.cn/app-sdk-client':
         specifier: 'catalog:'
-        version: 0.21.1
+        version: 0.21.2
       react:
         specifier: 'catalog:'
         version: 18.3.1
@@ -140,7 +140,7 @@ importers:
     dependencies:
       '@tbox.cn/app-sdk-server':
         specifier: 'catalog:'
-        version: 0.23.0
+        version: 0.24.1
       express:
         specifier: 'catalog:'
         version: 4.22.2
@@ -961,33 +961,25 @@ packages:
   '@standard-schema/spec@1.1.0':
     resolution: {integrity: sha512-l2aFy5jALhniG5HgqrD6jXLi/rUWrKvqN/qJx6yoJsgKhblVd+iqqU4RCXavm/jPityDo5TCvKMnpjKnOriy0w==}
 
-  '@tbox.cn/app-contracts@0.12.0':
-    resolution: {integrity: sha512-GFthajvUSE7tY6Y5kLJgg2dRuZQdLfxq/WAEHOh+Q7RTwg7mpuLsWiNhXISkXMAtpxg0RkSgtwyRq33QS0ay3w==}
+  '@tbox.cn/app-contracts@0.12.4':
+    resolution: {integrity: sha512-ukIpgL1pCKQmWzhHiqREKB5FeVmHqFWMdN5qwzrwwFheZHWGPwhZMxsputr9uOGZeOYXs3yRbKQPMbqUNemMAw==}
     engines: {node: '>=20.0.0'}
 
-  '@tbox.cn/app-contracts@0.12.3':
-    resolution: {integrity: sha512-b71WtU1Kk9rC3lwaefb48ymKPgkdb7MJcJQ0lTeUZu/jSNHsqQ4ZZI9ZUbHQ/rzYvWmZbdxe5H94328jAfJoVA==}
+  '@tbox.cn/app-sdk-client@0.21.2':
+    resolution: {integrity: sha512-ApJGzaTXNLKEzg6Gx85OjKsI2ZbtciMDAxRU712rdFxGKIp0pPaNCKhmXJSzhGdsh2Jf5F+PoZY4LXtCSrKNiQ==}
     engines: {node: '>=20.0.0'}
 
-  '@tbox.cn/app-sdk-client@0.21.1':
-    resolution: {integrity: sha512-hN+tIj8kh11PD0HMhq5KUs/nZYjxS+ps3F3HTTmOHWXNXzilYafFxeIWJ1bXKVm1Di5EUIjNaRPUDkP6HAcHvw==}
+  '@tbox.cn/app-sdk-core@0.20.3':
+    resolution: {integrity: sha512-3oR/UtV8LMYS/M62I/LLlXfajXTwGFA8JEbSZftq/XR6bfzADcx7skhVqJAVBvfRqRN9mUcs/UnuJFYKEIamIQ==}
     engines: {node: '>=20.0.0'}
 
-  '@tbox.cn/app-sdk-core@0.20.0':
-    resolution: {integrity: sha512-hvdcXntg4iJniVu9LEwo5A/vov3L08kRlJLTgStYRdAlH9AJXWLDxFITMNf7YJX8W+j9wjJmmS7Sv88iswxM+w==}
-    engines: {node: '>=20.0.0'}
-
-  '@tbox.cn/app-sdk-core@0.20.2':
-    resolution: {integrity: sha512-KDcFdIrIEOlwDvIqBu29CzR5vDjt0BCADMBrgrd5WlRqjrPM1/jM/RcaRO6gRuElmQCp5LfsoAkVeYTZE/6rpw==}
-    engines: {node: '>=20.0.0'}
-
-  '@tbox.cn/app-sdk-server@0.23.0':
-    resolution: {integrity: sha512-h+WtBjHF6ophOLj+amsiejZJ8TwoxLTmbnEmgfmUxDMgXHLzqJe/A/KAXN701ryku0IEDtIRXeWJ1szPLG9H5g==}
+  '@tbox.cn/app-sdk-server@0.24.1':
+    resolution: {integrity: sha512-/l2ST/m/o1gM2+v9jPWKaNkQC4iAAqg2E/4mV9KiEFsCgvB8gZ2FA1b9qyh2Dmijw/3azvhao32VMbM3nAv4Ng==}
     engines: {node: '>=20.0.0'}
     hasBin: true
 
-  '@tbox.cn/app-toolkit@0.7.3':
-    resolution: {integrity: sha512-Tdh1XkqRX0DGvTxflrfgJ4WFVW5wiq9cGOd7hpFrGzQ95mXFiSUKyQMgMtIum8kbReUq+aPI5hv8Z87AugZ1yQ==}
+  '@tbox.cn/app-toolkit@0.7.4':
+    resolution: {integrity: sha512-FHxlqD9mlL5OdfmjthDbIZKWIMcZTD2a5+TOGrNUHn9pML9z9gagBco/KqEKJNejzq0CXZeAKdYRtY5bFi4TSg==}
     engines: {node: '>=20.0.0'}
 
   '@types/babel__core@7.20.5':
@@ -2832,46 +2824,36 @@ snapshots:
 
   '@standard-schema/spec@1.1.0': {}
 
-  '@tbox.cn/app-contracts@0.12.0':
+  '@tbox.cn/app-contracts@0.12.4':
     dependencies:
       '@ag-ui/core': 0.0.47
       react: 18.3.1
       zod: 3.25.76
 
-  '@tbox.cn/app-contracts@0.12.3':
+  '@tbox.cn/app-sdk-client@0.21.2':
     dependencies:
-      '@ag-ui/core': 0.0.47
-      react: 18.3.1
-      zod: 3.25.76
-
-  '@tbox.cn/app-sdk-client@0.21.1':
-    dependencies:
-      '@tbox.cn/app-contracts': 0.12.0
-      '@tbox.cn/app-sdk-core': 0.20.0
+      '@tbox.cn/app-contracts': 0.12.4
+      '@tbox.cn/app-sdk-core': 0.20.3
       react: 18.3.1
       react-dom: 18.3.1(react@18.3.1)
 
-  '@tbox.cn/app-sdk-core@0.20.0':
-    dependencies:
-      '@tbox.cn/app-contracts': 0.12.0
-
-  '@tbox.cn/app-sdk-core@0.20.2':
+  '@tbox.cn/app-sdk-core@0.20.3':
     dependencies:
-      '@tbox.cn/app-contracts': 0.12.3
+      '@tbox.cn/app-contracts': 0.12.4
 
-  '@tbox.cn/app-sdk-server@0.23.0':
+  '@tbox.cn/app-sdk-server@0.24.1':
     dependencies:
       '@ag-ui/core': 0.0.47
-      '@tbox.cn/app-contracts': 0.12.3
-      '@tbox.cn/app-sdk-core': 0.20.2
-      '@tbox.cn/app-toolkit': 0.7.3
+      '@tbox.cn/app-contracts': 0.12.4
+      '@tbox.cn/app-sdk-core': 0.20.3
+      '@tbox.cn/app-toolkit': 0.7.4
       express: 4.22.2
       jose: 6.2.8
       zod: 3.25.76
     transitivePeerDependencies:
       - supports-color
 
-  '@tbox.cn/app-toolkit@0.7.3':
+  '@tbox.cn/app-toolkit@0.7.4':
     dependencies:
       ajv: 8.20.0
       zod: 3.25.76

package/pnpm-workspace.template.yaml

@@ -33,13 +33,13 @@ catalog:
   "@types/node": 24.13.3
   express: 4.22.2
   "@types/express": 4.17.25
-  "@tbox.cn/app-sdk-core": 0.20.2
-  "@tbox.cn/app-sdk-client": 0.21.1
-  "@tbox.cn/app-sdk-server": 0.23.0
-  "@tbox.cn/app-agent-sdk-server": 0.2.0
-  "@tbox.cn/app-agent-sdk-client": 0.1.4
-  "@tbox.cn/app-contracts": 0.12.3
-  "@tbox.cn/app-contracts-mall": 0.12.4
+  "@tbox.cn/app-sdk-core": 0.20.3
+  "@tbox.cn/app-sdk-client": 0.21.2
+  "@tbox.cn/app-sdk-server": 0.24.1
+  "@tbox.cn/app-agent-sdk-server": 0.2.2
+  "@tbox.cn/app-agent-sdk-client": 0.1.5
+  "@tbox.cn/app-contracts": 0.12.4
+  "@tbox.cn/app-contracts-mall": 0.12.5
   eslint: 9.39.5
   typescript-eslint: 8.67.0
   eslint-plugin-react-hooks: 5.2.0

package/scripts/stop.sh

@@ -1,5 +1,5 @@
 #!/bin/bash
-# 停止本应用全部进程。杀面收敛原则（docs/postmortem/0001）：
+# 停止本应用全部进程。杀面收敛原则（历史事故复盘沉淀）：
 # 1) cmdline 匹配：锚定本项目路径，逐字符 ERE 字面量化（BSD/GNU 无歧义），[^ ]* 锁单参数
 # 2) 端口定位：只取 LISTEN 态——持有连接的客户端（编排探活/代理父进程）不入杀面
 # PORT 契约：须与启动环境一致（生产形态 cmdline 不含路径，端口是唯一定位手段）