@cloudbase/manager-node 5.9.3 → 5.9.4

package/CHANGELOG.md

@@ -1,3 +1,6 @@
+## [5.9.3] 2026-10-27
+
+- [Added] env: 增加 HTTP 服务路由 UpstreamResourceVersion 字段
 ## [5.9.2] 2026-10-21
 
 - [Fixed] function: COS 上传超时改为连续无进度判定，避免大包被总耗时误杀

package/changelog_content_en.md

@@ -1,4 +1,3 @@
-## [5.9.2] 2026-10-21
+## [5.9.3] 2026-10-27
 
-- [Fixed] [TODO: translate] function: COS 上传超时改为连续无进度判定，避免大包被总耗时误杀
-- [Fixed] [TODO: translate] utils: 解压远程 zip 增加路径穿越防护并支持失败即中止
+- [Added] [TODO: translate] env: 增加 HTTP 服务路由 UpstreamResourceVersion 字段

package/lib/storage/index.js

@@ -2017,10 +2017,15 @@ class StorageService {
         if (fileSize !== undefined) {
             headers['Content-Length'] = String(fileSize);
         }
-        if (cacheControl !== undefined && cacheControl !== null) {
-            headers['Cache-Control'] =
-                typeof cacheControl === 'number' ? `max-age=${cacheControl}` : String(cacheControl);
-        }
+        // 未显式传入（含空白字符串）时默认 max-age=3600；注意保留 0 的语义（max-age=0）
+        const normalizedCacheControl = typeof cacheControl === 'string' && cacheControl.trim() === ''
+            ? undefined
+            : cacheControl;
+        const finalCacheControl = normalizedCacheControl !== null && normalizedCacheControl !== void 0 ? normalizedCacheControl : 3600;
+        headers['Cache-Control'] =
+            typeof finalCacheControl === 'number'
+                ? `max-age=${finalCacheControl}`
+                : String(finalCacheControl);
         if (metadata) {
             // x-metadata 放在 Header 里，具体大小限制由服务端/网关决定
             headers['x-metadata'] = Buffer.from(JSON.stringify(metadata), 'utf8').toString('base64');

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@cloudbase/manager-node",
-    "version": "5.9.3",
+    "version": "5.9.4",
     "description": "The node manage service api for cloudbase.",
     "main": "lib/index.js",
     "scripts": {

package/types/storage/type.d.ts

@@ -15,7 +15,8 @@ export interface IUploadObjectHttpOptions {
     /** 文件字节数；不传时若为 localPath/Buffer 会自动推断 */
     contentLength?: number;
     /**
-     * 缓存控制；传 number 自动转换为 max-age=<value>，传 string 直接作为 Cache-Control 头值
+     * 缓存控制；传 number 自动转换为 max-age=<value>，传 string 直接作为 Cache-Control 头值。
+     * 不传（含空字符串）时默认 3600（即 max-age=3600）；传 0 表示 max-age=0
      */
     cacheControl?: number | string;
     /** 自定义 metadata（JSON 对象），将以 Base64 编码后放入 x-metadata 头 */