@cloudbase/manager-node 5.9.2 → 5.9.4

package/CHANGELOG.md

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

package/changelog_content_en.md

@@ -1,6 +1,3 @@
-## [5.9.1] 2026-10-15
+## [5.9.3] 2026-10-27
 
-- [Added] [TODO: translate] function: CBF 环境支持 PutUrl 直传函数代码包
-- [Added] [TODO: translate] function: 新增流量策略 V2 与版本删除接口，切换 TCB 协议
-- [Fixed] [TODO: translate] error: 补齐新增代码的错误 code，通过 D31 与 code 取值来源守卫
-- [Fixed] [TODO: translate] function: 适配 CBF 环境接口限制并补齐版本/流量与 CBF 集成测试
+- [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.2",
+    "version": "5.9.4",
     "description": "The node manage service api for cloudbase.",
     "main": "lib/index.js",
     "scripts": {

package/types/env/type.d.ts

@@ -281,6 +281,7 @@ export interface HTTPServiceRoute {
     PathRewrite?: HTTPServicePathRewrite;
     UpstreamResourceType: 'SCF' | 'CBR' | 'STATIC_STORE' | 'WEB_SCF' | 'LH' | 'STORAGE';
     UpstreamResourceName: string;
+    UpstreamResourceVersion?: string;
     EnableSafeDomain: boolean;
     EnableAuth: boolean;
     EnablePathTransmission: boolean;
@@ -342,6 +343,7 @@ export interface HTTPServiceRouteParam {
     Path: string;
     UpstreamResourceType?: 'SCF' | 'CBR' | 'STATIC_STORE' | 'WEB_SCF' | 'LH' | 'STORAGE';
     UpstreamResourceName?: string;
+    UpstreamResourceVersion?: string;
     PathRewrite?: HTTPServicePathRewrite;
     EnableSafeDomain?: boolean;
     EnableAuth?: boolean;

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 头 */