@heybox/hb-sdk 0.9.1-alpha.6 → 0.9.1-alpha.8

package/dist/devtools/browser-dev-host/index.html

@@ -5,8 +5,8 @@
     <meta name="viewport" content="width=device-width, initial-scale=1.0" />
     <meta name="theme-color" content="#f4f5f7" />
     <title>小程序工坊调试台</title>
-    <script type="module" crossorigin src="/assets/index-Bqsp608m.js"></script>
-    <link rel="modulepreload" crossorigin href="/assets/desktop-app-launch-D6QZYpUq.js">
+    <script type="module" crossorigin src="/assets/index-BZBZfB4t.js"></script>
+    <link rel="modulepreload" crossorigin href="/assets/desktop-app-launch-BU-vzcs0.js">
     <link rel="stylesheet" crossorigin href="/assets/index-BRxbUJVN.css">
   </head>
   <body>

package/dist/index.cjs.js

@@ -425,6 +425,7 @@ const STORAGE_GET_STORAGE_METHOD = 'storage.getStorage';
 const STORAGE_SET_STORAGE_METHOD = 'storage.setStorage';
 const NETWORK_REQUEST_METHOD = 'network.request';
 const NETWORK_DOWNLOAD_METHOD = 'network.download';
+const NETWORK_UPLOAD_METHOD = 'network.upload';
 const FILES_PICK_FILES_METHOD = 'files.pickFiles';
 const FILES_PICK_DIRECTORY_METHOD = 'files.pickDirectory';
 const FILES_SAVE_FILE_METHOD = 'files.saveFile';
@@ -7277,7 +7278,7 @@ function createMessageId() {
 /** 构建时替换为当前发布包的实际版本。 */
 const HB_SDK_VERSION = typeof undefined === 'string'
     ? undefined
-    : '0.9.1-alpha.6';
+    : '0.9.1-alpha.8';
 
 const RUNTIME_MODES = new Set(['production', 'preview', 'development', 'unknown']);
 const OPERATING_SYSTEM_NAMES = new Set(['android', 'ios', 'ohos', 'windows', 'macos', 'linux', 'unknown']);
@@ -7323,6 +7324,8 @@ function readRecord$1(value) {
 }
 
 const DEFAULT_TIMEOUT = 10000;
+// 选择器等待由用户决定，使用长操作的生命周期清理，不设固定总时长。
+const FILE_PICKER_METHODS = new Set([FILES_PICK_FILES_METHOD, FILES_PICK_DIRECTORY_METHOD, FILES_SAVE_FILE_METHOD]);
 const HANDSHAKE_RETRY_INTERVAL = 250;
 /** 底层 bridge client，负责握手、请求响应、事件分发与超时清理。 */
 class MiniProgramBridgeClient {
@@ -7404,7 +7407,7 @@ class MiniProgramBridgeClient {
     }
     /** 调用父容器开放能力。 */
     async request(method, ...args) {
-        return this.performRequest(method, args[0], true);
+        return this.performRequest(method, args[0], !FILE_PICKER_METHODS.has(method));
     }
     /** 发起不使用固定总时长 timer 的长操作。 */
     async requestOperation(method, payload, options = {}) {
@@ -10734,8 +10737,82 @@ function createNetworkModule(requester) {
     return {
         request: (config) => request(requester, config),
         download: (options) => download(requester, options),
+        upload: (options) => upload(requester, options),
     };
 }
+/** 发起请求级可取消上传；传给 bridge 的只有文件引用和可序列化的元数据。 */
+async function upload(requester, options) {
+    if (!isPlainObject(options) || !options || !['raw', 'multipart'].includes(options.format)) {
+        throw createSDKError('INVALID_PARAMS', 'upload options 必须是带 format 的对象');
+    }
+    if (options.signal?.aborted)
+        throw createSDKError('UPLOAD_CANCELLED', '上传已取消');
+    const source = getFileHandleRegistry(requester).requireFile(options.from);
+    if (typeof options.url !== 'string' || !options.url)
+        throw createSDKError('INVALID_PARAMS', 'url 必须是非空字符串');
+    if (options.params !== undefined && (!isPlainObject(options.params) || containsUnsupportedNetworkData(options.params))) {
+        throw createSDKError('INVALID_PARAMS', 'params 必须是可序列化对象');
+    }
+    if (options.headers !== undefined &&
+        (!isPlainObject(options.headers) || Object.values(options.headers).some((value) => typeof value !== 'string'))) {
+        throw createSDKError('INVALID_PARAMS', 'headers 必须是字符串字典');
+    }
+    if (options.timeout !== undefined)
+        assertFinitePositive(options.timeout, 'timeout');
+    if (options.maxBytes !== undefined && (!Number.isSafeInteger(options.maxBytes) || options.maxBytes <= 0)) {
+        throw createSDKError('INVALID_PARAMS', 'maxBytes 必须是正的 safe integer');
+    }
+    if (options.onProgress !== undefined && typeof options.onProgress !== 'function')
+        throw createSDKError('INVALID_PARAMS', 'onProgress 必须是函数');
+    if (options.validateStatus !== undefined && typeof options.validateStatus !== 'function')
+        throw createSDKError('INVALID_PARAMS', 'validateStatus 必须是函数');
+    if (options.format === 'multipart' &&
+        options.fields !== undefined &&
+        (!isPlainObject(options.fields) || Object.values(options.fields).some((value) => typeof value !== 'string'))) {
+        throw createSDKError('INVALID_PARAMS', 'fields 必须是字符串字典');
+    }
+    const { signal, onProgress, validateStatus, from, ...metadata } = options;
+    const payload = {
+        ...metadata,
+        from: source.ref,
+        ...(options.params === undefined ? {} : { params: clonePublicValue(options.params) }),
+        ...(options.headers === undefined ? {} : { headers: { ...options.headers } }),
+        ...(options.format === 'multipart' && options.fields !== undefined ? { fields: { ...options.fields } } : {}),
+    };
+    const config = {
+        ...options,
+        ...(payload.params === undefined ? {} : { params: payload.params }),
+        ...(payload.headers === undefined ? {} : { headers: payload.headers }),
+        ...(payload.format === 'multipart' && payload.fields !== undefined ? { fields: payload.fields } : {}),
+    };
+    const result = await requester.requestOperation(NETWORK_UPLOAD_METHOD, payload, {
+        ...(signal === undefined ? {} : { signal }),
+        ...(onProgress === undefined
+            ? {}
+            : {
+                onProgress: (value) => {
+                    if (!isMiniProgramDownloadProgressPayload(value))
+                        return;
+                    try {
+                        onProgress({
+                            loaded: value.loaded,
+                            ...(value.total === undefined ? {} : { total: value.total }),
+                            lengthComputable: value.lengthComputable,
+                        });
+                    }
+                    catch {
+                        // 业务进度观察者不改变上传终态。
+                    }
+                },
+            }),
+        createAbortError: () => createSDKError('UPLOAD_CANCELLED', '上传已取消'),
+    });
+    const normalized = toNetworkResponse(result, config);
+    const response = { ...normalized, config };
+    if (!(validateStatus ?? DEFAULT_VALIDATE_STATUS)(response.status))
+        throw new HbMiniProgramNetworkError(response);
+    return response;
+}
 
 function invalidParams(message) {
     return createSDKError('INVALID_PARAMS', message);
@@ -11783,6 +11860,7 @@ const storage = {
 const network = {
     request: (config) => getDefaultSDK().network.request(config),
     download: (options) => getDefaultSDK().network.download(options),
+    upload: (options) => getDefaultSDK().network.upload(options),
 };
 /** 默认 SDK 实例的 files 模块。 */
 const files = {

package/dist/index.esm.js

@@ -421,6 +421,7 @@ const STORAGE_GET_STORAGE_METHOD = 'storage.getStorage';
 const STORAGE_SET_STORAGE_METHOD = 'storage.setStorage';
 const NETWORK_REQUEST_METHOD = 'network.request';
 const NETWORK_DOWNLOAD_METHOD = 'network.download';
+const NETWORK_UPLOAD_METHOD = 'network.upload';
 const FILES_PICK_FILES_METHOD = 'files.pickFiles';
 const FILES_PICK_DIRECTORY_METHOD = 'files.pickDirectory';
 const FILES_SAVE_FILE_METHOD = 'files.saveFile';
@@ -7273,7 +7274,7 @@ function createMessageId() {
 /** 构建时替换为当前发布包的实际版本。 */
 const HB_SDK_VERSION = typeof undefined === 'string'
     ? undefined
-    : '0.9.1-alpha.6';
+    : '0.9.1-alpha.8';
 
 const RUNTIME_MODES = new Set(['production', 'preview', 'development', 'unknown']);
 const OPERATING_SYSTEM_NAMES = new Set(['android', 'ios', 'ohos', 'windows', 'macos', 'linux', 'unknown']);
@@ -7319,6 +7320,8 @@ function readRecord$1(value) {
 }
 
 const DEFAULT_TIMEOUT = 10000;
+// 选择器等待由用户决定，使用长操作的生命周期清理，不设固定总时长。
+const FILE_PICKER_METHODS = new Set([FILES_PICK_FILES_METHOD, FILES_PICK_DIRECTORY_METHOD, FILES_SAVE_FILE_METHOD]);
 const HANDSHAKE_RETRY_INTERVAL = 250;
 /** 底层 bridge client，负责握手、请求响应、事件分发与超时清理。 */
 class MiniProgramBridgeClient {
@@ -7400,7 +7403,7 @@ class MiniProgramBridgeClient {
     }
     /** 调用父容器开放能力。 */
     async request(method, ...args) {
-        return this.performRequest(method, args[0], true);
+        return this.performRequest(method, args[0], !FILE_PICKER_METHODS.has(method));
     }
     /** 发起不使用固定总时长 timer 的长操作。 */
     async requestOperation(method, payload, options = {}) {
@@ -10730,8 +10733,82 @@ function createNetworkModule(requester) {
     return {
         request: (config) => request(requester, config),
         download: (options) => download(requester, options),
+        upload: (options) => upload(requester, options),
     };
 }
+/** 发起请求级可取消上传；传给 bridge 的只有文件引用和可序列化的元数据。 */
+async function upload(requester, options) {
+    if (!isPlainObject(options) || !options || !['raw', 'multipart'].includes(options.format)) {
+        throw createSDKError('INVALID_PARAMS', 'upload options 必须是带 format 的对象');
+    }
+    if (options.signal?.aborted)
+        throw createSDKError('UPLOAD_CANCELLED', '上传已取消');
+    const source = getFileHandleRegistry(requester).requireFile(options.from);
+    if (typeof options.url !== 'string' || !options.url)
+        throw createSDKError('INVALID_PARAMS', 'url 必须是非空字符串');
+    if (options.params !== undefined && (!isPlainObject(options.params) || containsUnsupportedNetworkData(options.params))) {
+        throw createSDKError('INVALID_PARAMS', 'params 必须是可序列化对象');
+    }
+    if (options.headers !== undefined &&
+        (!isPlainObject(options.headers) || Object.values(options.headers).some((value) => typeof value !== 'string'))) {
+        throw createSDKError('INVALID_PARAMS', 'headers 必须是字符串字典');
+    }
+    if (options.timeout !== undefined)
+        assertFinitePositive(options.timeout, 'timeout');
+    if (options.maxBytes !== undefined && (!Number.isSafeInteger(options.maxBytes) || options.maxBytes <= 0)) {
+        throw createSDKError('INVALID_PARAMS', 'maxBytes 必须是正的 safe integer');
+    }
+    if (options.onProgress !== undefined && typeof options.onProgress !== 'function')
+        throw createSDKError('INVALID_PARAMS', 'onProgress 必须是函数');
+    if (options.validateStatus !== undefined && typeof options.validateStatus !== 'function')
+        throw createSDKError('INVALID_PARAMS', 'validateStatus 必须是函数');
+    if (options.format === 'multipart' &&
+        options.fields !== undefined &&
+        (!isPlainObject(options.fields) || Object.values(options.fields).some((value) => typeof value !== 'string'))) {
+        throw createSDKError('INVALID_PARAMS', 'fields 必须是字符串字典');
+    }
+    const { signal, onProgress, validateStatus, from, ...metadata } = options;
+    const payload = {
+        ...metadata,
+        from: source.ref,
+        ...(options.params === undefined ? {} : { params: clonePublicValue(options.params) }),
+        ...(options.headers === undefined ? {} : { headers: { ...options.headers } }),
+        ...(options.format === 'multipart' && options.fields !== undefined ? { fields: { ...options.fields } } : {}),
+    };
+    const config = {
+        ...options,
+        ...(payload.params === undefined ? {} : { params: payload.params }),
+        ...(payload.headers === undefined ? {} : { headers: payload.headers }),
+        ...(payload.format === 'multipart' && payload.fields !== undefined ? { fields: payload.fields } : {}),
+    };
+    const result = await requester.requestOperation(NETWORK_UPLOAD_METHOD, payload, {
+        ...(signal === undefined ? {} : { signal }),
+        ...(onProgress === undefined
+            ? {}
+            : {
+                onProgress: (value) => {
+                    if (!isMiniProgramDownloadProgressPayload(value))
+                        return;
+                    try {
+                        onProgress({
+                            loaded: value.loaded,
+                            ...(value.total === undefined ? {} : { total: value.total }),
+                            lengthComputable: value.lengthComputable,
+                        });
+                    }
+                    catch {
+                        // 业务进度观察者不改变上传终态。
+                    }
+                },
+            }),
+        createAbortError: () => createSDKError('UPLOAD_CANCELLED', '上传已取消'),
+    });
+    const normalized = toNetworkResponse(result, config);
+    const response = { ...normalized, config };
+    if (!(validateStatus ?? DEFAULT_VALIDATE_STATUS)(response.status))
+        throw new HbMiniProgramNetworkError(response);
+    return response;
+}
 
 function invalidParams(message) {
     return createSDKError('INVALID_PARAMS', message);
@@ -11779,6 +11856,7 @@ const storage = {
 const network = {
     request: (config) => getDefaultSDK().network.request(config),
     download: (options) => getDefaultSDK().network.download(options),
+    upload: (options) => getDefaultSDK().network.upload(options),
 };
 /** 默认 SDK 实例的 files 模块。 */
 const files = {

package/dist/miniapp-publish.cjs.js

@@ -71,6 +71,7 @@ const MINI_PROGRAM_PERMISSION_CATALOG = [
         config: {},
         methods: [
             'network.download',
+            'network.upload',
             'files.pickFiles',
             'files.pickDirectory',
             'files.saveFile',
@@ -129,7 +130,7 @@ const MINI_PROGRAM_PERMISSION_CATALOG = [
                 description: '是否申请访问小黑盒官方域名。',
             },
         },
-        methods: ['network.request', 'network.download'],
+        methods: ['network.request', 'network.download', 'network.upload'],
         conditions: ['声明后仍需平台批准，并继续执行网络安全策略。'],
     },
     {

package/dist/miniapp-publish.esm.js

@@ -69,6 +69,7 @@ const MINI_PROGRAM_PERMISSION_CATALOG = [
         config: {},
         methods: [
             'network.download',
+            'network.upload',
             'files.pickFiles',
             'files.pickDirectory',
             'files.saveFile',
@@ -127,7 +128,7 @@ const MINI_PROGRAM_PERMISSION_CATALOG = [
                 description: '是否申请访问小黑盒官方域名。',
             },
         },
-        methods: ['network.request', 'network.download'],
+        methods: ['network.request', 'network.download', 'network.upload'],
         conditions: ['声明后仍需平台批准，并继续执行网络安全策略。'],
     },
     {

package/dist/protocol.cjs.js

@@ -46,6 +46,7 @@ const STORAGE_GET_STORAGE_METHOD = 'storage.getStorage';
 const STORAGE_SET_STORAGE_METHOD = 'storage.setStorage';
 const NETWORK_REQUEST_METHOD = 'network.request';
 const NETWORK_DOWNLOAD_METHOD = 'network.download';
+const NETWORK_UPLOAD_METHOD = 'network.upload';
 const FILES_PICK_FILES_METHOD = 'files.pickFiles';
 const FILES_PICK_DIRECTORY_METHOD = 'files.pickDirectory';
 const FILES_SAVE_FILE_METHOD = 'files.saveFile';
@@ -204,6 +205,13 @@ const MINI_PROGRAM_PROTOCOL_CAPABILITIES = [
         requirement: { kind: 'all', permissions: ['network', 'filesystem'] },
         risk: 'high',
     },
+    {
+        method: NETWORK_UPLOAD_METHOD,
+        module: 'network',
+        capability: NETWORK_UPLOAD_METHOD,
+        requirement: { kind: 'all', permissions: ['network', 'filesystem'] },
+        risk: 'high',
+    },
     {
         method: FILES_PICK_FILES_METHOD,
         module: 'files',
@@ -7208,6 +7216,7 @@ exports.NAVIGATION_OPEN_APP_PAGE_METHOD = NAVIGATION_OPEN_APP_PAGE_METHOD;
 exports.NAVIGATION_RELOAD_METHOD = NAVIGATION_RELOAD_METHOD;
 exports.NETWORK_DOWNLOAD_METHOD = NETWORK_DOWNLOAD_METHOD;
 exports.NETWORK_REQUEST_METHOD = NETWORK_REQUEST_METHOD;
+exports.NETWORK_UPLOAD_METHOD = NETWORK_UPLOAD_METHOD;
 exports.RUNTIME_LOCATION_PROBE_METHOD = RUNTIME_LOCATION_PROBE_METHOD;
 exports.SDK_CSP_VIOLATION_METHOD = SDK_CSP_VIOLATION_METHOD;
 exports.SDK_HANDSHAKE_METHOD = SDK_HANDSHAKE_METHOD;

package/dist/protocol.esm.js

@@ -44,6 +44,7 @@ const STORAGE_GET_STORAGE_METHOD = 'storage.getStorage';
 const STORAGE_SET_STORAGE_METHOD = 'storage.setStorage';
 const NETWORK_REQUEST_METHOD = 'network.request';
 const NETWORK_DOWNLOAD_METHOD = 'network.download';
+const NETWORK_UPLOAD_METHOD = 'network.upload';
 const FILES_PICK_FILES_METHOD = 'files.pickFiles';
 const FILES_PICK_DIRECTORY_METHOD = 'files.pickDirectory';
 const FILES_SAVE_FILE_METHOD = 'files.saveFile';
@@ -202,6 +203,13 @@ const MINI_PROGRAM_PROTOCOL_CAPABILITIES = [
         requirement: { kind: 'all', permissions: ['network', 'filesystem'] },
         risk: 'high',
     },
+    {
+        method: NETWORK_UPLOAD_METHOD,
+        module: 'network',
+        capability: NETWORK_UPLOAD_METHOD,
+        requirement: { kind: 'all', permissions: ['network', 'filesystem'] },
+        risk: 'high',
+    },
     {
         method: FILES_PICK_FILES_METHOD,
         module: 'files',
@@ -7172,4 +7180,4 @@ object({
   regions: array(viewRegionSchema).max(VIEW_BUDGET.maxRegions)
 });
 
-export { AUTH_LOGIN_METHOD, CLOUD_LEADERBOARD_DELETE_CURRENT_USER_ENTRY_METHOD, CLOUD_LEADERBOARD_GET_CURRENT_USER_ENTRY_METHOD, CLOUD_LEADERBOARD_GET_INFO_METHOD, CLOUD_LEADERBOARD_GET_LIST_METHOD, CLOUD_LEADERBOARD_SUBMIT_METHOD, DEVICE_EXECUTE_PROTOCOL_METHOD, DEVICE_SET_CLIPBOARD_METHOD, DEVICE_VIBRATE_METHOD, DIRECTORY_CREATE_METHOD, DIRECTORY_EXISTS_METHOD, DIRECTORY_LIST_METHOD, DIRECTORY_REMOVE_METHOD, FILES_PICK_DIRECTORY_METHOD, FILES_PICK_FILES_METHOD, FILES_SAVE_FILE_METHOD, FILE_CREATE_METHOD, FILE_EXISTS_METHOD, FILE_READ_BYTES_METHOD, FILE_READ_TEXT_METHOD, FILE_REMOVE_METHOD, FILE_STAT_METHOD, FILE_WRITE_BYTES_METHOD, FILE_WRITE_TEXT_METHOD, MINI_PROGRAM_BRIDGE_NONCE_PARAM, MINI_PROGRAM_MESSAGE_NAMESPACE, MINI_PROGRAM_MESSAGE_VERSION, MINI_PROGRAM_OPERATION_PROGRESS_METHOD, MINI_PROGRAM_PROTOCOL_CAPABILITIES, NAVIGATION_CLOSE_METHOD, NAVIGATION_OPEN_APP_PAGE_METHOD, NAVIGATION_RELOAD_METHOD, NETWORK_DOWNLOAD_METHOD, NETWORK_REQUEST_METHOD, RUNTIME_LOCATION_PROBE_METHOD, SDK_CSP_VIOLATION_METHOD, SDK_HANDSHAKE_METHOD, SDK_LOCATION_REPORT_METHOD, SHARE_COPY_LINK_METHOD, SHARE_SCREENSHOT_METHOD, SHARE_SHOW_SHARE_MENU_METHOD, STORAGE_GET_STORAGE_METHOD, STORAGE_SET_STORAGE_METHOD, UI_HIDE_LOADING_METHOD, UI_SHOW_LOADING_METHOD, UI_SHOW_TOAST_METHOD, USER_GET_INFO_METHOD, USER_GET_STEAM_GAME_LIST_METHOD, USER_INFO_AUTHORIZATION_SCOPES, USER_REVOKE_AUTHORIZATION_METHOD, VIEWPORT_GET_WINDOW_INFO_METHOD, VIEWPORT_SET_DISPLAY_METHOD, VIEWPORT_SET_NAVIGATION_BAR_STYLE_METHOD, isManagedMiniProgramRuntimePermissionKey, isMiniProgramBridgeMessage, isMiniProgramByteArray, isMiniProgramDirectoryDescriptor, isMiniProgramDirectoryRef, isMiniProgramDownloadProgressPayload, isMiniProgramFileDescriptor, isMiniProgramFileRef, isMiniProgramFileStat, isMiniProgramFileSystemEntityDescriptor, isMiniProgramPathRootRef, isMiniProgramRelativePath, parseMiniProgramRuntimePermissions };
+export { AUTH_LOGIN_METHOD, CLOUD_LEADERBOARD_DELETE_CURRENT_USER_ENTRY_METHOD, CLOUD_LEADERBOARD_GET_CURRENT_USER_ENTRY_METHOD, CLOUD_LEADERBOARD_GET_INFO_METHOD, CLOUD_LEADERBOARD_GET_LIST_METHOD, CLOUD_LEADERBOARD_SUBMIT_METHOD, DEVICE_EXECUTE_PROTOCOL_METHOD, DEVICE_SET_CLIPBOARD_METHOD, DEVICE_VIBRATE_METHOD, DIRECTORY_CREATE_METHOD, DIRECTORY_EXISTS_METHOD, DIRECTORY_LIST_METHOD, DIRECTORY_REMOVE_METHOD, FILES_PICK_DIRECTORY_METHOD, FILES_PICK_FILES_METHOD, FILES_SAVE_FILE_METHOD, FILE_CREATE_METHOD, FILE_EXISTS_METHOD, FILE_READ_BYTES_METHOD, FILE_READ_TEXT_METHOD, FILE_REMOVE_METHOD, FILE_STAT_METHOD, FILE_WRITE_BYTES_METHOD, FILE_WRITE_TEXT_METHOD, MINI_PROGRAM_BRIDGE_NONCE_PARAM, MINI_PROGRAM_MESSAGE_NAMESPACE, MINI_PROGRAM_MESSAGE_VERSION, MINI_PROGRAM_OPERATION_PROGRESS_METHOD, MINI_PROGRAM_PROTOCOL_CAPABILITIES, NAVIGATION_CLOSE_METHOD, NAVIGATION_OPEN_APP_PAGE_METHOD, NAVIGATION_RELOAD_METHOD, NETWORK_DOWNLOAD_METHOD, NETWORK_REQUEST_METHOD, NETWORK_UPLOAD_METHOD, RUNTIME_LOCATION_PROBE_METHOD, SDK_CSP_VIOLATION_METHOD, SDK_HANDSHAKE_METHOD, SDK_LOCATION_REPORT_METHOD, SHARE_COPY_LINK_METHOD, SHARE_SCREENSHOT_METHOD, SHARE_SHOW_SHARE_MENU_METHOD, STORAGE_GET_STORAGE_METHOD, STORAGE_SET_STORAGE_METHOD, UI_HIDE_LOADING_METHOD, UI_SHOW_LOADING_METHOD, UI_SHOW_TOAST_METHOD, USER_GET_INFO_METHOD, USER_GET_STEAM_GAME_LIST_METHOD, USER_INFO_AUTHORIZATION_SCOPES, USER_REVOKE_AUTHORIZATION_METHOD, VIEWPORT_GET_WINDOW_INFO_METHOD, VIEWPORT_SET_DISPLAY_METHOD, VIEWPORT_SET_NAVIGATION_BAR_STYLE_METHOD, isManagedMiniProgramRuntimePermissionKey, isMiniProgramBridgeMessage, isMiniProgramByteArray, isMiniProgramDirectoryDescriptor, isMiniProgramDirectoryRef, isMiniProgramDownloadProgressPayload, isMiniProgramFileDescriptor, isMiniProgramFileRef, isMiniProgramFileStat, isMiniProgramFileSystemEntityDescriptor, isMiniProgramPathRootRef, isMiniProgramRelativePath, parseMiniProgramRuntimePermissions };

package/dist/vite.cjs.js

@@ -100,6 +100,7 @@ const MINI_PROGRAM_PERMISSION_CATALOG = [
         config: {},
         methods: [
             'network.download',
+            'network.upload',
             'files.pickFiles',
             'files.pickDirectory',
             'files.saveFile',
@@ -158,7 +159,7 @@ const MINI_PROGRAM_PERMISSION_CATALOG = [
                 description: '是否申请访问小黑盒官方域名。',
             },
         },
-        methods: ['network.request', 'network.download'],
+        methods: ['network.request', 'network.download', 'network.upload'],
         conditions: ['声明后仍需平台批准，并继续执行网络安全策略。'],
     },
     {
@@ -10281,7 +10282,7 @@ async function ensureBasicInfoDirectory(rootPath, relative) {
 /** 构建时替换为当前发布包的实际版本。 */
 const HB_SDK_VERSION = typeof undefined === 'string'
     ? undefined
-    : '0.9.1-alpha.6';
+    : '0.9.1-alpha.8';
 
 /**
  * iframe 与调试台页面的开发期 console 捕获转发。

package/dist/vite.esm.js

@@ -97,6 +97,7 @@ const MINI_PROGRAM_PERMISSION_CATALOG = [
         config: {},
         methods: [
             'network.download',
+            'network.upload',
             'files.pickFiles',
             'files.pickDirectory',
             'files.saveFile',
@@ -155,7 +156,7 @@ const MINI_PROGRAM_PERMISSION_CATALOG = [
                 description: '是否申请访问小黑盒官方域名。',
             },
         },
-        methods: ['network.request', 'network.download'],
+        methods: ['network.request', 'network.download', 'network.upload'],
         conditions: ['声明后仍需平台批准，并继续执行网络安全策略。'],
     },
     {
@@ -10278,7 +10279,7 @@ async function ensureBasicInfoDirectory(rootPath, relative) {
 /** 构建时替换为当前发布包的实际版本。 */
 const HB_SDK_VERSION = typeof undefined === 'string'
     ? undefined
-    : '0.9.1-alpha.6';
+    : '0.9.1-alpha.8';
 
 /**
  * iframe 与调试台页面的开发期 console 捕获转发。

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@heybox/hb-sdk",
-  "version": "0.9.1-alpha.6",
+  "version": "0.9.1-alpha.8",
   "sideEffects": [
     "./src/index.ts",
     "./src/core/singleton.ts",
@@ -75,7 +75,7 @@
     "undici": "^7.28.0",
     "ws": "^8.18.0",
     "sharp": "^0.34.5",
-    "@heybox/hb-sdk-protocol": "0.9.1-alpha.6"
+    "@heybox/hb-sdk-protocol": "0.9.1-alpha.8"
   },
   "peerDependencies": {
     "vite": ">=5"
@@ -128,11 +128,11 @@
     "@ai-desktop/view-contract": "file:../hb-sdk-protocol/vendor/view-contract-2.2.2-6ac49bbf6410.tgz",
     "rollup-plugin-dts": "6.4.0",
     "@heybox-domain/heybox-theme": "~0.1.0",
-    "@heybox-domain/heybox-vue3-ui": "~0.1.0",
-    "@heybox/hb-api": "~1.28.14",
-    "@heybox/hb-sdk-runtime": "~0.9.1-alpha.6",
+    "@heybox/hb-sdk-runtime": "~0.9.1-alpha.8",
     "@heybox/runtime": "~0.2.1",
     "@heybox/runtime-policy": "~0.2.1",
+    "@heybox/hb-api": "~1.28.14",
+    "@heybox-domain/heybox-vue3-ui": "~0.1.0",
     "@heybox/runtime-transport-fetch": "~0.2.1"
   },
   "publishConfig": {

package/skill/skill.json

@@ -1,15 +1,15 @@
 {
   "name": "hb-sdk",
-  "skillVersion": "0.9.1-alpha.6+skill.3260e7d71ada",
+  "skillVersion": "0.9.1-alpha.8+skill.3260e7d71ada",
   "sdk": {
     "package": "@heybox/hb-sdk",
-    "version": "0.9.1-alpha.6",
-    "compatibility": "0.9.1-alpha.6"
+    "version": "0.9.1-alpha.8",
+    "compatibility": "0.9.1-alpha.8"
   },
   "distribution": {
     "type": "npm",
     "package": "@heybox/hb-sdk",
-    "version": "0.9.1-alpha.6",
+    "version": "0.9.1-alpha.8",
     "path": "skill"
   },
   "integrity": "sha256-3260e7d71ada646d5d8b269490e3de4b5ecd3fe824b18cdb73fe64247738ffea"

package/types/index.d.ts

@@ -1332,6 +1332,7 @@ interface FilesModule {
      * 必须直接从按钮点击等可信用户操作调用。不要先 `await` 握手或其他异步任务；应提前通过
      * `getHandshakeState()` / `onHandshakeStateChange()` 控制按钮只在 ready 时可用，再在点击回调
      * 中立即调用 picker。取消是正常用户结果，应按 `FILE_PICKER_CANCELLED` 结束当前流程。
+     * 选择器等待不设固定超时；用户确认、取消或当前 SDK / Runtime 会话结束后才结束操作。
      *
      * 默认 `mode: 'read'`、`multiple: false` 且无 `accept`。返回的是用户选择范围内的精确外部
      * File direct handles，不是浏览器原生 `File`，不能扩张到父目录或兄弟文件；每项授权只在
@@ -1421,6 +1422,7 @@ interface FilesModule {
      * 必须直接从按钮点击等可信用户操作调用。不要先 `await` 握手或其他异步任务；应提前通过
      * `getHandshakeState()` / `onHandshakeStateChange()` 控制按钮只在 ready 时可用，再在点击回调
      * 中立即调用 picker。取消是正常用户结果，应按 `FILE_PICKER_CANCELLED` 结束当前流程。
+     * 选择器等待不设固定超时；用户确认、取消或当前 SDK / Runtime 会话结束后才结束操作。
      *
      * 默认授权模式为 `read`。返回的是用户选择范围的精确外部目录授权，只在当前 Runtime
      * session 有效；session 结束或授权撤销后不能恢复或持久化复用。其 `file()` / `directory()`
@@ -1507,6 +1509,7 @@ interface FilesModule {
      * 必须直接从按钮点击等可信用户操作调用。不要先 `await` 握手或其他异步任务；应提前通过
      * `getHandshakeState()` / `onHandshakeStateChange()` 控制按钮只在 ready 时可用，再在点击回调
      * 中立即调用。取消是正常用户结果，应按 `FILE_PICKER_CANCELLED` 结束当前流程。
+     * 选择器等待不设固定超时；用户确认、取消或当前 SDK / Runtime 会话结束后才结束操作。
      *
      * 返回的是当前 Runtime session 内一个精确外部 File 授权，不会额外保留或暴露父 Directory
      * handle。它占用 picker / `saveFile()` 共享的 1024 direct-handle 配额中的一个；session 结束
@@ -1747,6 +1750,61 @@ type DownloadOptions = DownloadBaseOptions & ({
     /** 是否允许原子创建或替换目录内的同名文件，默认 `false`；`false` 时采用独占创建。 */
     overwrite?: boolean;
 });
+/** 上传进度仅统计文件内容字节；100% 不表示服务端已经接受本次上传。 */
+interface UploadProgress {
+    /** 已交给 Host 传输层的文件内容字节数，不表示服务端已保存。 */
+    loaded: number;
+    /** Host 可以确定文件大小时提供的总字节数。 */
+    total?: number;
+    /** 总大小是否已知；空文件的 total 可以为 0。 */
+    lengthComputable: boolean;
+}
+/** 单文件流式上传的公共选项。 */
+interface UploadBaseOptions {
+    /** 开发者指定的 HTTPS URL；官方域名与重定向首版不支持。 */
+    url: string;
+    /** 当前 SDK 会话的可读 FileHandle；不接受浏览器 File、Blob 或本机路径。 */
+    from: FileHandle;
+    /** 由 Host 编码的查询参数。 */
+    params?: MiniProgramNetworkParams;
+    /** 应用请求头；multipart 的 Content-Type 与 boundary 由 Host 生成。 */
+    headers?: MiniProgramNetworkHeaders;
+    /** 网络空闲超时，单位毫秒；不是上传的固定总时长。 */
+    timeout?: number;
+    /** 文件内容大小上限，必须是正的 safe integer；不包含 multipart 元数据。 */
+    maxBytes?: number;
+    /** 取消本次上传；取消或超时不能保证服务端没有保存数据。 */
+    signal?: AbortSignal;
+    /** 当前请求的文件字节进度；回调抛错不影响上传。 */
+    onProgress?: (progress: UploadProgress) => void;
+    /** SDK 侧 HTTP 状态校验，默认只接受 2xx。 */
+    validateStatus?: MiniProgramNetworkValidateStatus;
+}
+/** raw 默认 PUT，也支持 POST；multipart 固定 POST 且仅含一个文件。 */
+type UploadOptions = UploadBaseOptions & ({
+    format: 'raw';
+    method?: 'PUT' | 'POST';
+    fieldName?: never;
+    fields?: never;
+    fileName?: never;
+    contentType?: never;
+} | {
+    format: 'multipart';
+    method?: 'POST';
+    /** 文件表单字段名，不得与 fields 的字段名重复。 */
+    fieldName: string;
+    /** 字符串表单字段；复杂值由调用方自行序列化。 */
+    fields?: Record<string, string>;
+    /** 单个安全文件名，默认使用 from.name。 */
+    fileName?: string;
+    /** 文件 part 的 MIME type，默认 application/octet-stream。 */
+    contentType?: string;
+});
+/** 上传完成后的 HTTP 响应；data 的泛型不执行运行时 schema 校验。 */
+interface UploadResponse<T = unknown> extends NetworkResponsePayload<T> {
+    /** SDK 在调用时构造的配置快照，保留原始 FileHandle。 */
+    config: UploadOptions;
+}
 /**
  * bridge / runtime 可消费的网络请求 payload。
  *
@@ -1984,6 +2042,32 @@ interface MiniProgramNetworkModule {
      * @hbClient macos none
      */
     download(options: DownloadOptions): Promise<FileHandle>;
+    /**
+     * 将受控文件直接流式上传至开发者指定的 URL。
+     *
+     * @remarks
+     * 要求 network 与 filesystem 权限，只需文件的读权限。文件字节不经过 iframe bridge。
+     * 上传绑定当前 Runtime 会话，不自动重试、不分片、不续传，也不预先复制文件快照。
+     * 调用方必须保证上传期间源文件不被修改；Host 检测到变化时失败，但不能可靠发现所有修改。
+     * 进度达到 100% 后仍需等待 HTTP 响应。取消、超时或网络失败不能撤销服务端的副作用。
+     *
+     * @param options - 源文件、URL、上传格式、请求头、限制与请求级进度/取消选项。
+     * @returns 标准化 HTTP 响应；默认仅 2xx resolve。
+     * @throws HbMiniProgramNetworkError HTTP 状态未通过 validateStatus。
+     * @throws HbMiniProgramSDKError 文件、参数、权限、传输或 Host 能力错误。
+     * @since 0.9.1-alpha.7
+     * @hbPlatform android
+     * @hbPlatform ios
+     * @hbPlatform ohos
+     * @hbPlatform windows
+     * @hbPlatform macos
+     * @hbClient android none
+     * @hbClient ios none
+     * @hbClient ohos none
+     * @hbClient windows none
+     * @hbClient macos none
+     */
+    upload<T = unknown>(options: UploadOptions): Promise<UploadResponse<T>>;
 }
 
 /**
@@ -7534,4 +7618,4 @@ declare const hbSDK: {
 };
 
 export { HbMiniProgramNetworkError, HbMiniProgramSDKError, auth, cloud, companion, hbSDK as default, device, environment, files, getHandshakeState, navigation, network, off, on, onHandshakeStateChange, share, storage, ui, user, viewport, workspaceCards };
-export type { ClosePayload, CloseResult, CompanionAttachments, CompanionExitHandler, CompanionNotification, CompanionNotifications, CompanionOutputHandler, CompanionOwnershipLostHandler, CompanionPrepareOptions, CompanionSession, CompanionState, CompanionStateChangeHandler, CompanionStdio, CopyLinkPayload, CopyLinkResult, CreateOptions, DeleteCurrentUserLeaderboardEntryPayload, DeleteCurrentUserLeaderboardEntryResult, DirectoryHandle, DownloadBaseOptions, DownloadOptions, DownloadProgress, FileHandle, FileMode, FileStat, FileSystem, FileSystemEntity, FilesModule, GetCurrentUserLeaderboardEntryPayload, GetCurrentUserLeaderboardEntryResult, GetLeaderboardInfoPayload, GetLeaderboardInfoResult, GetLeaderboardListPayload, GetLeaderboardListResult, GetSteamGameListOptions, GetSteamGameListPayload, GetSteamGameListResult, GetStoragePayload, GetStorageResult, GetUserInfoPayload, GetUserInfoResult, GetWindowInfoPayload, GetWindowInfoResult, HideLoadingPayload, HideLoadingResult, LeaderboardEntry, LeaderboardOrder, ListOptions, LoginOptions, LoginPayload, LoginResult, LoginScope, MiniProgramAppPageTarget, MiniProgramAuthModule, MiniProgramCloudLeaderboardModule, MiniProgramCloudModule, MiniProgramCompanionModule, MiniProgramCopyLinkOptions, MiniProgramDeviceModule, MiniProgramEnvironmentInfo, MiniProgramEnvironmentModule, MiniProgramEventHandler, MiniProgramGameDetailGameType, MiniProgramGameDetailPage, MiniProgramNavigationBarForegroundStyle, MiniProgramNavigationModule, MiniProgramNetworkHeaders, MiniProgramNetworkModule, MiniProgramNetworkParams, MiniProgramNetworkRequestConfig, MiniProgramNetworkRequestMethod, MiniProgramNetworkResponse, MiniProgramNetworkValidateStatus, MiniProgramSDKHandshakeState, MiniProgramSDKHandshakeStateHandler, MiniProgramSafeArea, MiniProgramScreenshotOptions, MiniProgramScreenshotRect, MiniProgramSetNavigationBarStyleOptions, MiniProgramShareChannel, MiniProgramShareExtraValue, MiniProgramShareModule, MiniProgramSharePostOptions, MiniProgramShowShareMenuOptions, MiniProgramStorageModule, MiniProgramToastStatus, MiniProgramUiModule, MiniProgramUserModule, MiniProgramVibrateIntensity, MiniProgramViewportModule, MiniProgramWindowInfoResult, NetworkRequestPayload, NetworkResponsePayload, OpenAppPageOptions, OpenAppPagePayload, OpenAppPageResult, OpenGameDetailAppPageOptions, OpenGameDetailAppPagePayload, OpenMiniProgramAppPageOptions, OpenMiniProgramAppPagePayload, OpenPostDetailAppPageOptions, OpenPostDetailAppPagePayload, OpenUserDetailAppPageOptions, OpenUserDetailAppPagePayload, PathRoot, PickDirectoryOptions, PickFilesOptions, ReloadPayload, ReloadResult, RemoveOptions, RevokeAuthorizationPayload, RevokeAuthorizationResult, SaveFileOptions, ScreenshotPayload, ScreenshotResult, SetClipboardPayload, SetClipboardResult, SetNavigationBarStylePayload, SetNavigationBarStyleResult, SetStoragePayload, ShowLoadingPayload, ShowLoadingResult, ShowShareMenuPayload, ShowShareMenuResult, ShowToastPayload, ShowToastResult, SteamGameListData, SteamGameListItem, SteamGameListSort, SteamGamePrice, SubmitLeaderboardEntryPayload, SubmitLeaderboardEntryResult, VibratePayload, VibrateResult, WorkspaceCardsModule };
+export type { ClosePayload, CloseResult, CompanionAttachments, CompanionExitHandler, CompanionNotification, CompanionNotifications, CompanionOutputHandler, CompanionOwnershipLostHandler, CompanionPrepareOptions, CompanionSession, CompanionState, CompanionStateChangeHandler, CompanionStdio, CopyLinkPayload, CopyLinkResult, CreateOptions, DeleteCurrentUserLeaderboardEntryPayload, DeleteCurrentUserLeaderboardEntryResult, DirectoryHandle, DownloadBaseOptions, DownloadOptions, DownloadProgress, FileHandle, FileMode, FileStat, FileSystem, FileSystemEntity, FilesModule, GetCurrentUserLeaderboardEntryPayload, GetCurrentUserLeaderboardEntryResult, GetLeaderboardInfoPayload, GetLeaderboardInfoResult, GetLeaderboardListPayload, GetLeaderboardListResult, GetSteamGameListOptions, GetSteamGameListPayload, GetSteamGameListResult, GetStoragePayload, GetStorageResult, GetUserInfoPayload, GetUserInfoResult, GetWindowInfoPayload, GetWindowInfoResult, HideLoadingPayload, HideLoadingResult, LeaderboardEntry, LeaderboardOrder, ListOptions, LoginOptions, LoginPayload, LoginResult, LoginScope, MiniProgramAppPageTarget, MiniProgramAuthModule, MiniProgramCloudLeaderboardModule, MiniProgramCloudModule, MiniProgramCompanionModule, MiniProgramCopyLinkOptions, MiniProgramDeviceModule, MiniProgramEnvironmentInfo, MiniProgramEnvironmentModule, MiniProgramEventHandler, MiniProgramGameDetailGameType, MiniProgramGameDetailPage, MiniProgramNavigationBarForegroundStyle, MiniProgramNavigationModule, MiniProgramNetworkHeaders, MiniProgramNetworkModule, MiniProgramNetworkParams, MiniProgramNetworkRequestConfig, MiniProgramNetworkRequestMethod, MiniProgramNetworkResponse, MiniProgramNetworkValidateStatus, MiniProgramSDKHandshakeState, MiniProgramSDKHandshakeStateHandler, MiniProgramSafeArea, MiniProgramScreenshotOptions, MiniProgramScreenshotRect, MiniProgramSetNavigationBarStyleOptions, MiniProgramShareChannel, MiniProgramShareExtraValue, MiniProgramShareModule, MiniProgramSharePostOptions, MiniProgramShowShareMenuOptions, MiniProgramStorageModule, MiniProgramToastStatus, MiniProgramUiModule, MiniProgramUserModule, MiniProgramVibrateIntensity, MiniProgramViewportModule, MiniProgramWindowInfoResult, NetworkRequestPayload, NetworkResponsePayload, OpenAppPageOptions, OpenAppPagePayload, OpenAppPageResult, OpenGameDetailAppPageOptions, OpenGameDetailAppPagePayload, OpenMiniProgramAppPageOptions, OpenMiniProgramAppPagePayload, OpenPostDetailAppPageOptions, OpenPostDetailAppPagePayload, OpenUserDetailAppPageOptions, OpenUserDetailAppPagePayload, PathRoot, PickDirectoryOptions, PickFilesOptions, ReloadPayload, ReloadResult, RemoveOptions, RevokeAuthorizationPayload, RevokeAuthorizationResult, SaveFileOptions, ScreenshotPayload, ScreenshotResult, SetClipboardPayload, SetClipboardResult, SetNavigationBarStylePayload, SetNavigationBarStyleResult, SetStoragePayload, ShowLoadingPayload, ShowLoadingResult, ShowShareMenuPayload, ShowShareMenuResult, ShowToastPayload, ShowToastResult, SteamGameListData, SteamGameListItem, SteamGameListSort, SteamGamePrice, SubmitLeaderboardEntryPayload, SubmitLeaderboardEntryResult, UploadBaseOptions, UploadOptions, UploadProgress, UploadResponse, VibratePayload, VibrateResult, WorkspaceCardsModule };