@heybox/hb-sdk 0.4.3 → 0.4.5

package/dist/index.cjs.js

@@ -473,6 +473,20 @@ const STORAGE_SET_STORAGE_METHOD = 'storage.setStorage';
  * 供 SDK 与父容器 runtime 共享同一 bridge method 标识。
  */
 const NETWORK_REQUEST_METHOD = 'network.request';
+/** 展示 toast 能力方法名。 */
+const UI_SHOW_TOAST_METHOD = 'ui.showToast';
+/** 展示全局 loading 能力方法名。 */
+const UI_SHOW_LOADING_METHOD = 'ui.showLoading';
+/** 隐藏全局 loading 能力方法名。 */
+const UI_HIDE_LOADING_METHOD = 'ui.hideLoading';
+/** 震动反馈能力方法名。 */
+const DEVICE_VIBRATE_METHOD = 'device.vibrate';
+/** 写入文本剪贴板能力方法名。 */
+const DEVICE_SET_CLIPBOARD_METHOD = 'device.setClipboard';
+/** 关闭当前小程序容器能力方法名。 */
+const NAVIGATION_CLOSE_METHOD = 'navigation.close';
+/** 重载当前小程序容器能力方法名。 */
+const NAVIGATION_RELOAD_METHOD = 'navigation.reload';
 
 /**
  * 唤起登录授权，并在流程返回后刷新用户公开基础资料。
@@ -728,6 +742,59 @@ function createUserModule(requester) {
     };
 }
 
+/** 展示 toast。 */
+function showToast(requester, options) {
+    return requester.request(UI_SHOW_TOAST_METHOD, options);
+}
+/** 展示全局 loading。 */
+function showLoading(requester, options) {
+    return requester.request(UI_SHOW_LOADING_METHOD, options ?? {});
+}
+/** 隐藏全局 loading。 */
+function hideLoading(requester) {
+    return requester.request(UI_HIDE_LOADING_METHOD);
+}
+/** 创建 UI 模块。 */
+function createUiModule(requester) {
+    return {
+        showToast: options => showToast(requester, options),
+        showLoading: options => showLoading(requester, options),
+        hideLoading: () => hideLoading(requester),
+    };
+}
+
+/** 触发宿主震动反馈。 */
+function vibrate(requester, options) {
+    return requester.request(DEVICE_VIBRATE_METHOD, options ?? {});
+}
+/** 写入系统文本剪贴板。 */
+function setClipboard(requester, options) {
+    return requester.request(DEVICE_SET_CLIPBOARD_METHOD, options);
+}
+/** 创建设备能力模块。 */
+function createDeviceModule(requester) {
+    return {
+        vibrate: options => vibrate(requester, options),
+        setClipboard: options => setClipboard(requester, options),
+    };
+}
+
+/** 请求宿主关闭当前小程序容器。 */
+function close(requester) {
+    return requester.request(NAVIGATION_CLOSE_METHOD);
+}
+/** 请求宿主重载当前小程序容器。 */
+function reload(requester) {
+    return requester.request(NAVIGATION_RELOAD_METHOD);
+}
+/** 创建导航能力模块。 */
+function createNavigationModule(requester) {
+    return {
+        close: () => close(requester),
+        reload: () => reload(requester),
+    };
+}
+
 /**
  * 外部小程序 SDK 实例。
  *
@@ -763,6 +830,12 @@ class MiniProgramSDK {
     storage;
     /** 网络请求相关开放能力。 */
     network;
+    /** UI 交互相关开放能力。 */
+    ui;
+    /** 设备相关开放能力。 */
+    device;
+    /** 导航与容器控制相关开放能力。 */
+    navigation;
     constructor(options) {
         this.client = new MiniProgramBridgeClient(options);
         this.auth = createAuthModule(this.client);
@@ -771,6 +844,9 @@ class MiniProgramSDK {
         this.viewport = createViewportModule(this.client);
         this.storage = createStorageModule(this.client);
         this.network = createNetworkModule(this.client);
+        this.ui = createUiModule(this.client);
+        this.device = createDeviceModule(this.client);
+        this.navigation = createNavigationModule(this.client);
     }
     /**
      * 等待 SDK 与父容器完成握手。
@@ -896,6 +972,22 @@ const storage = {
 const network = {
     request: config => getDefaultSDK().network.request(config),
 };
+/** 默认 SDK 实例的 UI 模块。 */
+const ui = {
+    showToast: options => getDefaultSDK().ui.showToast(options),
+    showLoading: options => getDefaultSDK().ui.showLoading(options),
+    hideLoading: () => getDefaultSDK().ui.hideLoading(),
+};
+/** 默认 SDK 实例的 device 模块。 */
+const device = {
+    vibrate: options => getDefaultSDK().device.vibrate(options),
+    setClipboard: options => getDefaultSDK().device.setClipboard(options),
+};
+/** 默认 SDK 实例的 navigation 模块。 */
+const navigation = {
+    close: () => getDefaultSDK().navigation.close(),
+    reload: () => getDefaultSDK().navigation.reload(),
+};
 
 const hbSDK = {
     ready,
@@ -907,6 +999,9 @@ const hbSDK = {
     viewport,
     storage,
     network,
+    ui,
+    device,
+    navigation,
 };
 
 exports.HbMiniProgramNetworkError = HbMiniProgramNetworkError;
@@ -915,11 +1010,14 @@ exports.MiniProgramSDK = MiniProgramSDK;
 exports.auth = auth;
 exports.createMiniProgramSDK = createMiniProgramSDK;
 exports.default = hbSDK;
+exports.device = device;
+exports.navigation = navigation;
 exports.network = network;
 exports.off = off;
 exports.on = on;
 exports.ready = ready;
 exports.share = share;
 exports.storage = storage;
+exports.ui = ui;
 exports.user = user;
 exports.viewport = viewport;

package/dist/index.esm.js

@@ -469,6 +469,20 @@ const STORAGE_SET_STORAGE_METHOD = 'storage.setStorage';
  * 供 SDK 与父容器 runtime 共享同一 bridge method 标识。
  */
 const NETWORK_REQUEST_METHOD = 'network.request';
+/** 展示 toast 能力方法名。 */
+const UI_SHOW_TOAST_METHOD = 'ui.showToast';
+/** 展示全局 loading 能力方法名。 */
+const UI_SHOW_LOADING_METHOD = 'ui.showLoading';
+/** 隐藏全局 loading 能力方法名。 */
+const UI_HIDE_LOADING_METHOD = 'ui.hideLoading';
+/** 震动反馈能力方法名。 */
+const DEVICE_VIBRATE_METHOD = 'device.vibrate';
+/** 写入文本剪贴板能力方法名。 */
+const DEVICE_SET_CLIPBOARD_METHOD = 'device.setClipboard';
+/** 关闭当前小程序容器能力方法名。 */
+const NAVIGATION_CLOSE_METHOD = 'navigation.close';
+/** 重载当前小程序容器能力方法名。 */
+const NAVIGATION_RELOAD_METHOD = 'navigation.reload';
 
 /**
  * 唤起登录授权，并在流程返回后刷新用户公开基础资料。
@@ -724,6 +738,59 @@ function createUserModule(requester) {
     };
 }
 
+/** 展示 toast。 */
+function showToast(requester, options) {
+    return requester.request(UI_SHOW_TOAST_METHOD, options);
+}
+/** 展示全局 loading。 */
+function showLoading(requester, options) {
+    return requester.request(UI_SHOW_LOADING_METHOD, options ?? {});
+}
+/** 隐藏全局 loading。 */
+function hideLoading(requester) {
+    return requester.request(UI_HIDE_LOADING_METHOD);
+}
+/** 创建 UI 模块。 */
+function createUiModule(requester) {
+    return {
+        showToast: options => showToast(requester, options),
+        showLoading: options => showLoading(requester, options),
+        hideLoading: () => hideLoading(requester),
+    };
+}
+
+/** 触发宿主震动反馈。 */
+function vibrate(requester, options) {
+    return requester.request(DEVICE_VIBRATE_METHOD, options ?? {});
+}
+/** 写入系统文本剪贴板。 */
+function setClipboard(requester, options) {
+    return requester.request(DEVICE_SET_CLIPBOARD_METHOD, options);
+}
+/** 创建设备能力模块。 */
+function createDeviceModule(requester) {
+    return {
+        vibrate: options => vibrate(requester, options),
+        setClipboard: options => setClipboard(requester, options),
+    };
+}
+
+/** 请求宿主关闭当前小程序容器。 */
+function close(requester) {
+    return requester.request(NAVIGATION_CLOSE_METHOD);
+}
+/** 请求宿主重载当前小程序容器。 */
+function reload(requester) {
+    return requester.request(NAVIGATION_RELOAD_METHOD);
+}
+/** 创建导航能力模块。 */
+function createNavigationModule(requester) {
+    return {
+        close: () => close(requester),
+        reload: () => reload(requester),
+    };
+}
+
 /**
  * 外部小程序 SDK 实例。
  *
@@ -759,6 +826,12 @@ class MiniProgramSDK {
     storage;
     /** 网络请求相关开放能力。 */
     network;
+    /** UI 交互相关开放能力。 */
+    ui;
+    /** 设备相关开放能力。 */
+    device;
+    /** 导航与容器控制相关开放能力。 */
+    navigation;
     constructor(options) {
         this.client = new MiniProgramBridgeClient(options);
         this.auth = createAuthModule(this.client);
@@ -767,6 +840,9 @@ class MiniProgramSDK {
         this.viewport = createViewportModule(this.client);
         this.storage = createStorageModule(this.client);
         this.network = createNetworkModule(this.client);
+        this.ui = createUiModule(this.client);
+        this.device = createDeviceModule(this.client);
+        this.navigation = createNavigationModule(this.client);
     }
     /**
      * 等待 SDK 与父容器完成握手。
@@ -892,6 +968,22 @@ const storage = {
 const network = {
     request: config => getDefaultSDK().network.request(config),
 };
+/** 默认 SDK 实例的 UI 模块。 */
+const ui = {
+    showToast: options => getDefaultSDK().ui.showToast(options),
+    showLoading: options => getDefaultSDK().ui.showLoading(options),
+    hideLoading: () => getDefaultSDK().ui.hideLoading(),
+};
+/** 默认 SDK 实例的 device 模块。 */
+const device = {
+    vibrate: options => getDefaultSDK().device.vibrate(options),
+    setClipboard: options => getDefaultSDK().device.setClipboard(options),
+};
+/** 默认 SDK 实例的 navigation 模块。 */
+const navigation = {
+    close: () => getDefaultSDK().navigation.close(),
+    reload: () => getDefaultSDK().navigation.reload(),
+};
 
 const hbSDK = {
     ready,
@@ -903,6 +995,9 @@ const hbSDK = {
     viewport,
     storage,
     network,
+    ui,
+    device,
+    navigation,
 };
 
-export { HbMiniProgramNetworkError, HbMiniProgramSDKError, MiniProgramSDK, auth, createMiniProgramSDK, hbSDK as default, network, off, on, ready, share, storage, user, viewport };
+export { HbMiniProgramNetworkError, HbMiniProgramSDKError, MiniProgramSDK, auth, createMiniProgramSDK, hbSDK as default, device, navigation, network, off, on, ready, share, storage, ui, user, viewport };

package/dist/miniapp-publish.cjs.js

@@ -2811,8 +2811,21 @@ function getMiniappManifestVersionError(version) {
 
 const MINIAPP_UPLOAD_SCOPE = 'activity';
 const ACTIVITY_UPLOAD_KEY_MAX_LENGTH = 64;
+const USER_MINIPROGRAM_ACCESS_STATUS_API_PATH = '/mall/developer/user_miniprogram/access_status';
+const LIST_USER_MINIPROGRAM_API_PATH = '/mall/developer/user_miniprogram/list';
+const CREATE_USER_MINIPROGRAM_API_PATH = '/mall/developer/user_miniprogram/create';
+const UPDATE_USER_MINIPROGRAM_API_PATH = '/mall/developer/user_miniprogram/update';
+const DETAIL_USER_MINIPROGRAM_API_PATH = '/mall/developer/user_miniprogram/detail';
+const USER_MINIPROGRAM_PREVIEW_ALLOWLIST_API_PATH = '/mall/developer/user_miniprogram/preview_allowlist';
+const UPDATE_USER_MINIPROGRAM_PREVIEW_ALLOWLIST_API_PATH = '/mall/developer/user_miniprogram/preview_allowlist/update';
 const PRECHECK_USER_MINIPROGRAM_VERSION_API_PATH = '/mall/developer/user_miniprogram/version/precheck';
 const SUBMIT_USER_MINIPROGRAM_AUDIT_API_PATH = '/mall/developer/user_miniprogram/version/submit_audit';
+const USER_MINIPROGRAM_VERSION_PREVIEW_INFO_API_PATH = '/mall/developer/user_miniprogram/version/preview_info';
+const WITHDRAW_USER_MINIPROGRAM_VERSION_API_PATH = '/mall/developer/user_miniprogram/version/withdraw';
+const RELEASE_USER_MINIPROGRAM_VERSION_API_PATH = '/mall/developer/user_miniprogram/version/release';
+const TAKE_DOWN_USER_MINIPROGRAM_API_PATH = '/mall/developer/user_miniprogram/take_down';
+const REOPEN_USER_MINIPROGRAM_API_PATH = '/mall/developer/user_miniprogram/reopen';
+const LIST_USER_MINIPROGRAM_VERSION_API_PATH = '/mall/developer/user_miniprogram/version/list';
 const FNV_OFFSET = 0x811c9dc5;
 const FNV_PRIME = 0x01000193;
 function normalizeRelativePath(relativePath) {
@@ -2872,9 +2885,22 @@ function shouldUploadDistFile(relativePath) {
 }
 
 exports.ACTIVITY_UPLOAD_KEY_MAX_LENGTH = ACTIVITY_UPLOAD_KEY_MAX_LENGTH;
+exports.CREATE_USER_MINIPROGRAM_API_PATH = CREATE_USER_MINIPROGRAM_API_PATH;
+exports.DETAIL_USER_MINIPROGRAM_API_PATH = DETAIL_USER_MINIPROGRAM_API_PATH;
+exports.LIST_USER_MINIPROGRAM_API_PATH = LIST_USER_MINIPROGRAM_API_PATH;
+exports.LIST_USER_MINIPROGRAM_VERSION_API_PATH = LIST_USER_MINIPROGRAM_VERSION_API_PATH;
 exports.MINIAPP_UPLOAD_SCOPE = MINIAPP_UPLOAD_SCOPE;
 exports.PRECHECK_USER_MINIPROGRAM_VERSION_API_PATH = PRECHECK_USER_MINIPROGRAM_VERSION_API_PATH;
+exports.RELEASE_USER_MINIPROGRAM_VERSION_API_PATH = RELEASE_USER_MINIPROGRAM_VERSION_API_PATH;
+exports.REOPEN_USER_MINIPROGRAM_API_PATH = REOPEN_USER_MINIPROGRAM_API_PATH;
 exports.SUBMIT_USER_MINIPROGRAM_AUDIT_API_PATH = SUBMIT_USER_MINIPROGRAM_AUDIT_API_PATH;
+exports.TAKE_DOWN_USER_MINIPROGRAM_API_PATH = TAKE_DOWN_USER_MINIPROGRAM_API_PATH;
+exports.UPDATE_USER_MINIPROGRAM_API_PATH = UPDATE_USER_MINIPROGRAM_API_PATH;
+exports.UPDATE_USER_MINIPROGRAM_PREVIEW_ALLOWLIST_API_PATH = UPDATE_USER_MINIPROGRAM_PREVIEW_ALLOWLIST_API_PATH;
+exports.USER_MINIPROGRAM_ACCESS_STATUS_API_PATH = USER_MINIPROGRAM_ACCESS_STATUS_API_PATH;
+exports.USER_MINIPROGRAM_PREVIEW_ALLOWLIST_API_PATH = USER_MINIPROGRAM_PREVIEW_ALLOWLIST_API_PATH;
+exports.USER_MINIPROGRAM_VERSION_PREVIEW_INFO_API_PATH = USER_MINIPROGRAM_VERSION_PREVIEW_INFO_API_PATH;
+exports.WITHDRAW_USER_MINIPROGRAM_VERSION_API_PATH = WITHDRAW_USER_MINIPROGRAM_VERSION_API_PATH;
 exports.getMiniProgramUploadAlias = getMiniProgramUploadAlias;
 exports.getMiniappUploadKey = getMiniappUploadKey;
 exports.isValidVersion = isValidMiniappManifestVersion;

package/dist/miniapp-publish.esm.js

@@ -2809,8 +2809,21 @@ function getMiniappManifestVersionError(version) {
 
 const MINIAPP_UPLOAD_SCOPE = 'activity';
 const ACTIVITY_UPLOAD_KEY_MAX_LENGTH = 64;
+const USER_MINIPROGRAM_ACCESS_STATUS_API_PATH = '/mall/developer/user_miniprogram/access_status';
+const LIST_USER_MINIPROGRAM_API_PATH = '/mall/developer/user_miniprogram/list';
+const CREATE_USER_MINIPROGRAM_API_PATH = '/mall/developer/user_miniprogram/create';
+const UPDATE_USER_MINIPROGRAM_API_PATH = '/mall/developer/user_miniprogram/update';
+const DETAIL_USER_MINIPROGRAM_API_PATH = '/mall/developer/user_miniprogram/detail';
+const USER_MINIPROGRAM_PREVIEW_ALLOWLIST_API_PATH = '/mall/developer/user_miniprogram/preview_allowlist';
+const UPDATE_USER_MINIPROGRAM_PREVIEW_ALLOWLIST_API_PATH = '/mall/developer/user_miniprogram/preview_allowlist/update';
 const PRECHECK_USER_MINIPROGRAM_VERSION_API_PATH = '/mall/developer/user_miniprogram/version/precheck';
 const SUBMIT_USER_MINIPROGRAM_AUDIT_API_PATH = '/mall/developer/user_miniprogram/version/submit_audit';
+const USER_MINIPROGRAM_VERSION_PREVIEW_INFO_API_PATH = '/mall/developer/user_miniprogram/version/preview_info';
+const WITHDRAW_USER_MINIPROGRAM_VERSION_API_PATH = '/mall/developer/user_miniprogram/version/withdraw';
+const RELEASE_USER_MINIPROGRAM_VERSION_API_PATH = '/mall/developer/user_miniprogram/version/release';
+const TAKE_DOWN_USER_MINIPROGRAM_API_PATH = '/mall/developer/user_miniprogram/take_down';
+const REOPEN_USER_MINIPROGRAM_API_PATH = '/mall/developer/user_miniprogram/reopen';
+const LIST_USER_MINIPROGRAM_VERSION_API_PATH = '/mall/developer/user_miniprogram/version/list';
 const FNV_OFFSET = 0x811c9dc5;
 const FNV_PRIME = 0x01000193;
 function normalizeRelativePath(relativePath) {
@@ -2869,4 +2882,4 @@ function shouldUploadDistFile(relativePath) {
     return true;
 }
 
-export { ACTIVITY_UPLOAD_KEY_MAX_LENGTH, MINIAPP_UPLOAD_SCOPE, PRECHECK_USER_MINIPROGRAM_VERSION_API_PATH, SUBMIT_USER_MINIPROGRAM_AUDIT_API_PATH, getMiniProgramUploadAlias, getMiniappUploadKey, isValidMiniappManifestVersion as isValidVersion, normalizeRelativePath, relativePathContainsNodeModulesSegment, shouldUploadDistFile, validateUploadPaths };
+export { ACTIVITY_UPLOAD_KEY_MAX_LENGTH, CREATE_USER_MINIPROGRAM_API_PATH, DETAIL_USER_MINIPROGRAM_API_PATH, LIST_USER_MINIPROGRAM_API_PATH, LIST_USER_MINIPROGRAM_VERSION_API_PATH, MINIAPP_UPLOAD_SCOPE, PRECHECK_USER_MINIPROGRAM_VERSION_API_PATH, RELEASE_USER_MINIPROGRAM_VERSION_API_PATH, REOPEN_USER_MINIPROGRAM_API_PATH, SUBMIT_USER_MINIPROGRAM_AUDIT_API_PATH, TAKE_DOWN_USER_MINIPROGRAM_API_PATH, UPDATE_USER_MINIPROGRAM_API_PATH, UPDATE_USER_MINIPROGRAM_PREVIEW_ALLOWLIST_API_PATH, USER_MINIPROGRAM_ACCESS_STATUS_API_PATH, USER_MINIPROGRAM_PREVIEW_ALLOWLIST_API_PATH, USER_MINIPROGRAM_VERSION_PREVIEW_INFO_API_PATH, WITHDRAW_USER_MINIPROGRAM_VERSION_API_PATH, getMiniProgramUploadAlias, getMiniappUploadKey, isValidMiniappManifestVersion as isValidVersion, normalizeRelativePath, relativePathContainsNodeModulesSegment, shouldUploadDistFile, validateUploadPaths };

package/dist/protocol.cjs.js

@@ -89,6 +89,20 @@ const STORAGE_SET_STORAGE_METHOD = 'storage.setStorage';
  * 供 SDK 与父容器 runtime 共享同一 bridge method 标识。
  */
 const NETWORK_REQUEST_METHOD = 'network.request';
+/** 展示 toast 能力方法名。 */
+const UI_SHOW_TOAST_METHOD = 'ui.showToast';
+/** 展示全局 loading 能力方法名。 */
+const UI_SHOW_LOADING_METHOD = 'ui.showLoading';
+/** 隐藏全局 loading 能力方法名。 */
+const UI_HIDE_LOADING_METHOD = 'ui.hideLoading';
+/** 震动反馈能力方法名。 */
+const DEVICE_VIBRATE_METHOD = 'device.vibrate';
+/** 写入文本剪贴板能力方法名。 */
+const DEVICE_SET_CLIPBOARD_METHOD = 'device.setClipboard';
+/** 关闭当前小程序容器能力方法名。 */
+const NAVIGATION_CLOSE_METHOD = 'navigation.close';
+/** 重载当前小程序容器能力方法名。 */
+const NAVIGATION_RELOAD_METHOD = 'navigation.reload';
 /**
  * 小程序开放能力目录。
  *
@@ -159,19 +173,75 @@ const MINI_PROGRAM_PROTOCOL_CAPABILITIES = [
         permission: 'network.request',
         risk: 'high',
     },
+    {
+        method: UI_SHOW_TOAST_METHOD,
+        module: 'ui',
+        capability: UI_SHOW_TOAST_METHOD,
+        permission: 'ui.toast',
+        risk: 'low',
+    },
+    {
+        method: UI_SHOW_LOADING_METHOD,
+        module: 'ui',
+        capability: UI_SHOW_LOADING_METHOD,
+        permission: 'ui.loading',
+        risk: 'low',
+    },
+    {
+        method: UI_HIDE_LOADING_METHOD,
+        module: 'ui',
+        capability: UI_HIDE_LOADING_METHOD,
+        permission: 'ui.loading',
+        risk: 'low',
+    },
+    {
+        method: DEVICE_VIBRATE_METHOD,
+        module: 'device',
+        capability: DEVICE_VIBRATE_METHOD,
+        permission: 'device.vibrate',
+        risk: 'low',
+    },
+    {
+        method: DEVICE_SET_CLIPBOARD_METHOD,
+        module: 'device',
+        capability: DEVICE_SET_CLIPBOARD_METHOD,
+        permission: 'device.clipboard.write',
+        risk: 'medium',
+    },
+    {
+        method: NAVIGATION_CLOSE_METHOD,
+        module: 'navigation',
+        capability: NAVIGATION_CLOSE_METHOD,
+        permission: 'navigation.close',
+        risk: 'medium',
+    },
+    {
+        method: NAVIGATION_RELOAD_METHOD,
+        module: 'navigation',
+        capability: NAVIGATION_RELOAD_METHOD,
+        permission: 'navigation.reload',
+        risk: 'medium',
+    },
 ];
 
 exports.AUTH_LOGIN_METHOD = AUTH_LOGIN_METHOD;
+exports.DEVICE_SET_CLIPBOARD_METHOD = DEVICE_SET_CLIPBOARD_METHOD;
+exports.DEVICE_VIBRATE_METHOD = DEVICE_VIBRATE_METHOD;
 exports.MINI_PROGRAM_BRIDGE_NONCE_PARAM = MINI_PROGRAM_BRIDGE_NONCE_PARAM;
 exports.MINI_PROGRAM_MESSAGE_NAMESPACE = MINI_PROGRAM_MESSAGE_NAMESPACE;
 exports.MINI_PROGRAM_MESSAGE_VERSION = MINI_PROGRAM_MESSAGE_VERSION;
 exports.MINI_PROGRAM_PROTOCOL_CAPABILITIES = MINI_PROGRAM_PROTOCOL_CAPABILITIES;
+exports.NAVIGATION_CLOSE_METHOD = NAVIGATION_CLOSE_METHOD;
+exports.NAVIGATION_RELOAD_METHOD = NAVIGATION_RELOAD_METHOD;
 exports.NETWORK_REQUEST_METHOD = NETWORK_REQUEST_METHOD;
 exports.SDK_HANDSHAKE_METHOD = SDK_HANDSHAKE_METHOD;
 exports.SHARE_SCREENSHOT_METHOD = SHARE_SCREENSHOT_METHOD;
 exports.SHARE_SHOW_SHARE_MENU_METHOD = SHARE_SHOW_SHARE_MENU_METHOD;
 exports.STORAGE_GET_STORAGE_METHOD = STORAGE_GET_STORAGE_METHOD;
 exports.STORAGE_SET_STORAGE_METHOD = STORAGE_SET_STORAGE_METHOD;
+exports.UI_HIDE_LOADING_METHOD = UI_HIDE_LOADING_METHOD;
+exports.UI_SHOW_LOADING_METHOD = UI_SHOW_LOADING_METHOD;
+exports.UI_SHOW_TOAST_METHOD = UI_SHOW_TOAST_METHOD;
 exports.USER_GET_INFO_METHOD = USER_GET_INFO_METHOD;
 exports.VIEWPORT_GET_WINDOW_INFO_METHOD = VIEWPORT_GET_WINDOW_INFO_METHOD;
 exports.VIEWPORT_SET_NAVIGATION_BAR_STYLE_METHOD = VIEWPORT_SET_NAVIGATION_BAR_STYLE_METHOD;

package/dist/protocol.esm.js

@@ -87,6 +87,20 @@ const STORAGE_SET_STORAGE_METHOD = 'storage.setStorage';
  * 供 SDK 与父容器 runtime 共享同一 bridge method 标识。
  */
 const NETWORK_REQUEST_METHOD = 'network.request';
+/** 展示 toast 能力方法名。 */
+const UI_SHOW_TOAST_METHOD = 'ui.showToast';
+/** 展示全局 loading 能力方法名。 */
+const UI_SHOW_LOADING_METHOD = 'ui.showLoading';
+/** 隐藏全局 loading 能力方法名。 */
+const UI_HIDE_LOADING_METHOD = 'ui.hideLoading';
+/** 震动反馈能力方法名。 */
+const DEVICE_VIBRATE_METHOD = 'device.vibrate';
+/** 写入文本剪贴板能力方法名。 */
+const DEVICE_SET_CLIPBOARD_METHOD = 'device.setClipboard';
+/** 关闭当前小程序容器能力方法名。 */
+const NAVIGATION_CLOSE_METHOD = 'navigation.close';
+/** 重载当前小程序容器能力方法名。 */
+const NAVIGATION_RELOAD_METHOD = 'navigation.reload';
 /**
  * 小程序开放能力目录。
  *
@@ -157,6 +171,55 @@ const MINI_PROGRAM_PROTOCOL_CAPABILITIES = [
         permission: 'network.request',
         risk: 'high',
     },
+    {
+        method: UI_SHOW_TOAST_METHOD,
+        module: 'ui',
+        capability: UI_SHOW_TOAST_METHOD,
+        permission: 'ui.toast',
+        risk: 'low',
+    },
+    {
+        method: UI_SHOW_LOADING_METHOD,
+        module: 'ui',
+        capability: UI_SHOW_LOADING_METHOD,
+        permission: 'ui.loading',
+        risk: 'low',
+    },
+    {
+        method: UI_HIDE_LOADING_METHOD,
+        module: 'ui',
+        capability: UI_HIDE_LOADING_METHOD,
+        permission: 'ui.loading',
+        risk: 'low',
+    },
+    {
+        method: DEVICE_VIBRATE_METHOD,
+        module: 'device',
+        capability: DEVICE_VIBRATE_METHOD,
+        permission: 'device.vibrate',
+        risk: 'low',
+    },
+    {
+        method: DEVICE_SET_CLIPBOARD_METHOD,
+        module: 'device',
+        capability: DEVICE_SET_CLIPBOARD_METHOD,
+        permission: 'device.clipboard.write',
+        risk: 'medium',
+    },
+    {
+        method: NAVIGATION_CLOSE_METHOD,
+        module: 'navigation',
+        capability: NAVIGATION_CLOSE_METHOD,
+        permission: 'navigation.close',
+        risk: 'medium',
+    },
+    {
+        method: NAVIGATION_RELOAD_METHOD,
+        module: 'navigation',
+        capability: NAVIGATION_RELOAD_METHOD,
+        permission: 'navigation.reload',
+        risk: 'medium',
+    },
 ];
 
-export { AUTH_LOGIN_METHOD, MINI_PROGRAM_BRIDGE_NONCE_PARAM, MINI_PROGRAM_MESSAGE_NAMESPACE, MINI_PROGRAM_MESSAGE_VERSION, MINI_PROGRAM_PROTOCOL_CAPABILITIES, NETWORK_REQUEST_METHOD, SDK_HANDSHAKE_METHOD, SHARE_SCREENSHOT_METHOD, SHARE_SHOW_SHARE_MENU_METHOD, STORAGE_GET_STORAGE_METHOD, STORAGE_SET_STORAGE_METHOD, USER_GET_INFO_METHOD, VIEWPORT_GET_WINDOW_INFO_METHOD, VIEWPORT_SET_NAVIGATION_BAR_STYLE_METHOD, isMiniProgramBridgeMessage };
+export { AUTH_LOGIN_METHOD, DEVICE_SET_CLIPBOARD_METHOD, DEVICE_VIBRATE_METHOD, MINI_PROGRAM_BRIDGE_NONCE_PARAM, MINI_PROGRAM_MESSAGE_NAMESPACE, MINI_PROGRAM_MESSAGE_VERSION, MINI_PROGRAM_PROTOCOL_CAPABILITIES, NAVIGATION_CLOSE_METHOD, NAVIGATION_RELOAD_METHOD, NETWORK_REQUEST_METHOD, SDK_HANDSHAKE_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, VIEWPORT_GET_WINDOW_INFO_METHOD, VIEWPORT_SET_NAVIGATION_BAR_STYLE_METHOD, isMiniProgramBridgeMessage };

package/dist/templates/vue3-vite-ts/README.md.ejs

@@ -21,7 +21,7 @@ npm run deploy
 
 - `npm run dev`：启动本地 Vite 服务和 `hb-sdk` 内置 mock runtime host，适合本地调试 SDK 能力；调试页内可点击按钮在 Mac 版 APP 中启动同一页面，也可以选择局域网网卡后用手机小黑盒 APP 扫码调试。手机需要与电脑处在同一局域网，并使用支持小程序调试壳的新版小黑盒 APP。Codex、VSCode 等内嵌浏览器可能无法唤起系统 APP，需要时请在系统浏览器中打开同一个调试页后重试。
 - `npm run build`：先执行 TypeScript 检查，再构建生产产物。
-- `npm run deploy -- --release-note "..."`：构建、上传并提交当前小程序版本审核。部署前需要先把 `package.json` 中的 `heybox.miniProgramId` 改成后台分配的真实小程序 id，并执行过 `npx hb-sdk login`；默认审核通过后需在开放平台手动发布，如需审核通过后自动发布可追加 `--auto-publish`。
+- `npm run deploy -- --release-note "..."`：运行 `hb-sdk remote deploy`，构建、上传并提交当前小程序版本审核。部署前需要先通过 `hb-sdk remote create --name "..."` 创建并绑定远端小程序，或用 `hb-sdk remote bind <mini-program-id>` 绑定已有小程序，并执行过 `npx hb-sdk login`；默认审核通过后用 `hb-sdk remote versions` 查看状态，再用 `hb-sdk remote release <version>` 发布，如需审核通过后自动发布可追加 `--auto-publish`。顶层 `hb-sdk deploy` 已删除，不再作为兼容别名保留。
 
 ## 更多能力
 

package/dist/templates/vue3-vite-ts/package.json.ejs

@@ -9,7 +9,7 @@
   "scripts": {
     "hb-sdk": "hb-sdk",
     "dev": "hb-sdk dev",
-    "deploy": "hb-sdk deploy",
+    "deploy": "hb-sdk remote deploy",
     "build": "vue-tsc --noEmit && vite build",
     "preview": "vite preview",
     "typecheck": "vue-tsc --noEmit",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@heybox/hb-sdk",
-  "version": "0.4.3",
+  "version": "0.4.5",
   "description": "",
   "exports": {
     ".": {

package/skill/SKILL.md

@@ -48,24 +48,29 @@ Apply these instructions when writing, reviewing, or debugging code that consume
 
 1. Use `hb-sdk create <project-name>` to scaffold a standalone external mini-program template.
 2. Use `hb-sdk dev` for local browser debugging through the built-in mock runtime host.
-3. Use `hb-sdk deploy --release-note <text>` to build, upload, and submit the current project for audit. It reads `package.json.heybox.miniProgramId`, prechecks `package.json.version` before build, runs the project's `build` script via the package manager auto-detected by lockfile, uploads `dist/` to CDN (skipping `manifest.json`, `.DS_Store`, `.map`), then calls the submit-audit API.
-4. Use `hb-sdk deploy --skip-build --release-note <text>` only when the `dist/` directory is already prepared by an upstream CI stage. In this mode the CLI reads `dist/manifest.json.version` before precheck. Missing `dist/manifest.json` or `dist/index.html` aborts the run.
-5. Always provide a concise release note before deploy. Non-interactive environments must pass `--release-note`; interactive terminals may prompt for it. The default is manual release after approval; use `--auto-publish` when the audited version should automatically release after approval.
-6. For internal test/staging backend operations, use origin-only custom URLs: `HB_SDK_API_BASE_URL` or `hb-sdk deploy --api-base-url <url>` for deploy APIs, and `HB_SDK_LOGIN_BASE_URL` or `hb-sdk login --login-base-url <url>` for browser login. CLI flags override env vars. API base URLs must be Heybox trusted HTTPS origins by default; use `--allow-unsafe-api-base-url` or `HB_SDK_ALLOW_UNSAFE_API_BASE_URL=1` only for local backend debugging. Do not include path, query, or hash in these URLs.
-7. For development routing or gray validation, configure `packages/hb-sdk/src/cli/config.ts` with `@heybox/hb-types` `RylaiServiceTagConfig` (`default_tag` / path-specific `special_tag`) to attach `x-rylai-service-tag` and the matching `special_tag` query parameter to Heybox backend API requests.
-8. If deploy targets a custom login environment, pass the same `--login-base-url` or `HB_SDK_LOGIN_BASE_URL` used for `hb-sdk login`; deploy rejects cached CLI login state from a different login origin.
-9. Add `--verbose` / `-v` only when diagnosing failures; default CLI errors are intentionally concise, while verbose output includes backend envelope, HTTP status, trace fields, raw body, or original submit-audit failure details.
-10. Do not expect custom base URLs to affect `hb-sdk doctor`, npm latest checks, or mock-host `network.request()`.
-11. Use the Mock runtime host's "在 Mac 版 APP 中启动" button for Mac App debugging, or the "Mobile App" QR code after selecting a LAN interface for phone App debugging; the phone must be on the same LAN and use a Heybox App version that supports the mini-program dev shell.
-12. Use `--port`, `--mock-port`, and `--no-open` when the default Vite/mock ports or browser opening behavior need to be controlled.
-13. Use `hb-sdk login`, `hb-sdk login status`, and `hb-sdk login clear` only for the CLI's own Heybox auth cache.
-14. Use `hb-sdk doctor` to diagnose whether the local `hb-sdk` skill matches the installed SDK and remote latest skill metadata.
-15. Do not use `hb-sdk doctor` to auto-install skills; when installation or refresh is needed, tell the user to run `npx skills add https://open.xiaoheihe.cn/agent-skills/hb-sdk`.
-16. If doctor reports `SDK_MISMATCH`, upgrade `@heybox/hb-sdk@latest` before reinstalling the skill.
-17. Do not treat CLI login cache as iframe SDK login state; it does not change `auth.login()`, `user.getInfo()`, `network.request()`, or mock-user behavior.
-18. Keep the CLI and mock runtime under `@heybox/hb-sdk`; do not create or revive a separate mock runtime package.
-19. Do not pass `mini_program_id` as a CLI flag or environment variable; it must come from `package.json.heybox.miniProgramId`.
-20. Do not import deploy / upload internals from outside the CLI; the only externally consumable subpath for publish-pipeline helpers is `@heybox/hb-sdk/miniapp-publish`.
+3. Use `hb-sdk remote ...` for developer-owned remote mini-program management. Top-level `hb-sdk deploy` has been hard-cut and must not be recommended as a compatibility alias.
+4. Use `hb-sdk remote create --name <name>` to create a remote mini-program and bind the returned id into `package.json.heybox.miniProgramId`; use `hb-sdk remote bind <mini-program-id>` to bind an existing remote mini-program after manageability is verified.
+5. Use `hb-sdk remote info`, `hb-sdk remote update`, `hb-sdk remote list`, `hb-sdk remote access`, `hb-sdk remote versions`, `hb-sdk remote preview <version>`, and `hb-sdk remote allowlist ...` for read/basic/preview management workflows. Discovery commands may show multiple remote mini-programs, but write commands target the current project binding rather than arbitrary ids.
+6. Use `hb-sdk remote deploy --release-note <text>` to build, upload, and submit the current project for audit. It reads `package.json.heybox.miniProgramId`, prechecks `package.json.version` before build, runs the project's `build` script via the package manager auto-detected by lockfile, uploads `dist/` to CDN (skipping `manifest.json`, `.DS_Store`, `.map`), then calls the submit-audit API.
+7. Use `hb-sdk remote deploy --skip-build --release-note <text>` only when the `dist/` directory is already prepared by an upstream CI stage. In this mode the CLI reads `dist/manifest.json.version` before precheck. Missing `dist/manifest.json` or `dist/index.html` aborts the run.
+8. Always provide a concise release note before deploy. Non-interactive environments must pass `--release-note`; interactive terminals may prompt for it. The default is manual release after approval with `hb-sdk remote release <version>`; use `--auto-publish` when the audited version should automatically release after approval.
+9. Use `hb-sdk remote release <version>`, `hb-sdk remote withdraw <version>`, `hb-sdk remote take-down`, and `hb-sdk remote reopen` for dangerous remote changes. Interactive terminals should confirm after showing enough context; non-interactive environments must pass `--yes`.
+10. For internal test/staging backend operations, use origin-only custom URLs: `HB_SDK_API_BASE_URL` or `hb-sdk remote ... --api-base-url <url>` for remote platform APIs, and `HB_SDK_LOGIN_BASE_URL` or `hb-sdk login --login-base-url <url>` for browser login. CLI flags override env vars. API base URLs must be Heybox trusted HTTPS origins by default; use `--allow-unsafe-api-base-url` or `HB_SDK_ALLOW_UNSAFE_API_BASE_URL=1` only for local backend debugging. Do not include path, query, or hash in these URLs.
+11. For development routing or gray validation, configure `packages/hb-sdk/src/cli/config.ts` with `@heybox/hb-types` `RylaiServiceTagConfig` (`default_tag` / path-specific `special_tag`) to attach `x-rylai-service-tag` and the matching `special_tag` query parameter to Heybox backend API requests.
+12. If a remote command targets a custom login environment, pass the same `--login-base-url` or `HB_SDK_LOGIN_BASE_URL` used for `hb-sdk login`; remote commands reject cached CLI login state from a different login origin.
+13. Add `--verbose` / `-v` only when diagnosing failures; default CLI errors are intentionally concise, while verbose output includes backend envelope, HTTP status, trace fields, raw body, or original submit-audit failure details.
+14. Use `--json` for script consumption of `hb-sdk remote` commands. With `--json`, stdout must contain exactly one JSON object; progress, warnings, update reminders, and verbose diagnostics must not pollute stdout.
+15. Do not expect custom base URLs to affect `hb-sdk doctor`, npm latest checks, or mock-host `network.request()`.
+16. Use the Mock runtime host's "在 Mac 版 APP 中启动" button for Mac App debugging, or the "Mobile App" QR code after selecting a LAN interface for phone App debugging; the phone must be on the same LAN and use a Heybox App version that supports the mini-program dev shell.
+17. Use `--port`, `--mock-port`, and `--no-open` when the default Vite/mock ports or browser opening behavior need to be controlled.
+18. Use `hb-sdk login`, `hb-sdk login status`, and `hb-sdk login clear` only for the CLI's own Heybox auth cache. Keep `hb-sdk login` top-level; it is not a remote mini-program command.
+19. Use `hb-sdk doctor` to diagnose whether the local `hb-sdk` skill matches the installed SDK and remote latest skill metadata.
+20. Do not use `hb-sdk doctor` to auto-install skills; when installation or refresh is needed, tell the user to run `npx skills add https://open.xiaoheihe.cn/agent-skills/hb-sdk`.
+21. If doctor reports `SDK_MISMATCH`, upgrade `@heybox/hb-sdk@latest` before reinstalling the skill.
+22. Do not treat CLI login cache as iframe SDK login state; it does not change `auth.login()`, `user.getInfo()`, `network.request()`, or mock-user behavior.
+23. Keep the CLI and mock runtime under `@heybox/hb-sdk`; do not create or revive a separate mock runtime package.
+24. Do not pass `mini_program_id` as a CLI flag or environment variable; it must come from `package.json.heybox.miniProgramId`.
+25. Do not import deploy / upload internals from outside the CLI; the only externally consumable subpath for publish-pipeline helpers is `@heybox/hb-sdk/miniapp-publish`.
 
 ## Step 6: Preserve capability boundaries