@heybox/hb-sdk 0.5.10 → 0.5.11

package/dist/index.cjs.js

@@ -499,6 +499,16 @@ const NAVIGATION_CLOSE_METHOD = 'navigation.close';
 const NAVIGATION_RELOAD_METHOD = 'navigation.reload';
 /** 打开黑盒 App 页面能力方法名。 */
 const NAVIGATION_OPEN_APP_PAGE_METHOD = 'navigation.openAppPage';
+/** 提交当前用户排行榜分数能力方法名。 */
+const CLOUD_LEADERBOARD_SUBMIT_METHOD = 'cloud.leaderboard.submit';
+/** 读取排行榜列表能力方法名。 */
+const CLOUD_LEADERBOARD_GET_LIST_METHOD = 'cloud.leaderboard.getList';
+/** 读取当前用户排行榜记录能力方法名。 */
+const CLOUD_LEADERBOARD_GET_CURRENT_USER_ENTRY_METHOD = 'cloud.leaderboard.getCurrentUserEntry';
+/** 删除当前用户排行榜记录能力方法名。 */
+const CLOUD_LEADERBOARD_DELETE_CURRENT_USER_ENTRY_METHOD = 'cloud.leaderboard.deleteCurrentUserEntry';
+/** 读取排行榜基础信息能力方法名。 */
+const CLOUD_LEADERBOARD_GET_INFO_METHOD = 'cloud.leaderboard.getInfo';
 
 /**
  * 唤起登录授权，并在流程返回后刷新用户公开基础资料。
@@ -525,6 +535,18 @@ function createAuthModule(requester) {
     };
 }
 
+function createCloudModule(requester) {
+    return {
+        leaderboard: {
+            submit: (options) => requester.request(CLOUD_LEADERBOARD_SUBMIT_METHOD, options),
+            getList: (options) => requester.request(CLOUD_LEADERBOARD_GET_LIST_METHOD, options),
+            getCurrentUserEntry: (options) => requester.request(CLOUD_LEADERBOARD_GET_CURRENT_USER_ENTRY_METHOD, options),
+            deleteCurrentUserEntry: (options) => requester.request(CLOUD_LEADERBOARD_DELETE_CURRENT_USER_ENTRY_METHOD, options),
+            getInfo: (options) => requester.request(CLOUD_LEADERBOARD_GET_INFO_METHOD, options),
+        },
+    };
+}
+
 /**
  * 截图并唤起分享。
  *
@@ -979,6 +1001,8 @@ class MiniProgramSDK {
     device;
     /** 导航与容器控制相关开放能力。 */
     navigation;
+    /** 云端数据相关开放能力。 */
+    cloud;
     constructor(options) {
         this.client = new MiniProgramBridgeClient(options);
         this.auth = createAuthModule(this.client);
@@ -990,6 +1014,7 @@ class MiniProgramSDK {
         this.ui = createUiModule(this.client);
         this.device = createDeviceModule(this.client);
         this.navigation = createNavigationModule(this.client);
+        this.cloud = createCloudModule(this.client);
     }
     /**
      * 等待 SDK 与父容器完成握手。
@@ -1137,6 +1162,16 @@ const navigation = {
     reload: () => getDefaultSDK().navigation.reload(),
     openAppPage: options => getDefaultSDK().navigation.openAppPage(options),
 };
+/** 默认 SDK 实例的 cloud 模块。 */
+const cloud = {
+    leaderboard: {
+        submit: options => getDefaultSDK().cloud.leaderboard.submit(options),
+        getList: options => getDefaultSDK().cloud.leaderboard.getList(options),
+        getCurrentUserEntry: options => getDefaultSDK().cloud.leaderboard.getCurrentUserEntry(options),
+        deleteCurrentUserEntry: options => getDefaultSDK().cloud.leaderboard.deleteCurrentUserEntry(options),
+        getInfo: options => getDefaultSDK().cloud.leaderboard.getInfo(options),
+    },
+};
 
 const hbSDK = {
     ready,
@@ -1151,12 +1186,14 @@ const hbSDK = {
     ui,
     device,
     navigation,
+    cloud,
 };
 
 exports.HbMiniProgramNetworkError = HbMiniProgramNetworkError;
 exports.HbMiniProgramSDKError = HbMiniProgramSDKError;
 exports.MiniProgramSDK = MiniProgramSDK;
 exports.auth = auth;
+exports.cloud = cloud;
 exports.createMiniProgramSDK = createMiniProgramSDK;
 exports.default = hbSDK;
 exports.device = device;

package/dist/index.esm.js

@@ -495,6 +495,16 @@ const NAVIGATION_CLOSE_METHOD = 'navigation.close';
 const NAVIGATION_RELOAD_METHOD = 'navigation.reload';
 /** 打开黑盒 App 页面能力方法名。 */
 const NAVIGATION_OPEN_APP_PAGE_METHOD = 'navigation.openAppPage';
+/** 提交当前用户排行榜分数能力方法名。 */
+const CLOUD_LEADERBOARD_SUBMIT_METHOD = 'cloud.leaderboard.submit';
+/** 读取排行榜列表能力方法名。 */
+const CLOUD_LEADERBOARD_GET_LIST_METHOD = 'cloud.leaderboard.getList';
+/** 读取当前用户排行榜记录能力方法名。 */
+const CLOUD_LEADERBOARD_GET_CURRENT_USER_ENTRY_METHOD = 'cloud.leaderboard.getCurrentUserEntry';
+/** 删除当前用户排行榜记录能力方法名。 */
+const CLOUD_LEADERBOARD_DELETE_CURRENT_USER_ENTRY_METHOD = 'cloud.leaderboard.deleteCurrentUserEntry';
+/** 读取排行榜基础信息能力方法名。 */
+const CLOUD_LEADERBOARD_GET_INFO_METHOD = 'cloud.leaderboard.getInfo';
 
 /**
  * 唤起登录授权，并在流程返回后刷新用户公开基础资料。
@@ -521,6 +531,18 @@ function createAuthModule(requester) {
     };
 }
 
+function createCloudModule(requester) {
+    return {
+        leaderboard: {
+            submit: (options) => requester.request(CLOUD_LEADERBOARD_SUBMIT_METHOD, options),
+            getList: (options) => requester.request(CLOUD_LEADERBOARD_GET_LIST_METHOD, options),
+            getCurrentUserEntry: (options) => requester.request(CLOUD_LEADERBOARD_GET_CURRENT_USER_ENTRY_METHOD, options),
+            deleteCurrentUserEntry: (options) => requester.request(CLOUD_LEADERBOARD_DELETE_CURRENT_USER_ENTRY_METHOD, options),
+            getInfo: (options) => requester.request(CLOUD_LEADERBOARD_GET_INFO_METHOD, options),
+        },
+    };
+}
+
 /**
  * 截图并唤起分享。
  *
@@ -975,6 +997,8 @@ class MiniProgramSDK {
     device;
     /** 导航与容器控制相关开放能力。 */
     navigation;
+    /** 云端数据相关开放能力。 */
+    cloud;
     constructor(options) {
         this.client = new MiniProgramBridgeClient(options);
         this.auth = createAuthModule(this.client);
@@ -986,6 +1010,7 @@ class MiniProgramSDK {
         this.ui = createUiModule(this.client);
         this.device = createDeviceModule(this.client);
         this.navigation = createNavigationModule(this.client);
+        this.cloud = createCloudModule(this.client);
     }
     /**
      * 等待 SDK 与父容器完成握手。
@@ -1133,6 +1158,16 @@ const navigation = {
     reload: () => getDefaultSDK().navigation.reload(),
     openAppPage: options => getDefaultSDK().navigation.openAppPage(options),
 };
+/** 默认 SDK 实例的 cloud 模块。 */
+const cloud = {
+    leaderboard: {
+        submit: options => getDefaultSDK().cloud.leaderboard.submit(options),
+        getList: options => getDefaultSDK().cloud.leaderboard.getList(options),
+        getCurrentUserEntry: options => getDefaultSDK().cloud.leaderboard.getCurrentUserEntry(options),
+        deleteCurrentUserEntry: options => getDefaultSDK().cloud.leaderboard.deleteCurrentUserEntry(options),
+        getInfo: options => getDefaultSDK().cloud.leaderboard.getInfo(options),
+    },
+};
 
 const hbSDK = {
     ready,
@@ -1147,6 +1182,7 @@ const hbSDK = {
     ui,
     device,
     navigation,
+    cloud,
 };
 
-export { HbMiniProgramNetworkError, HbMiniProgramSDKError, MiniProgramSDK, auth, createMiniProgramSDK, hbSDK as default, device, navigation, network, off, on, ready, share, storage, ui, user, viewport };
+export { HbMiniProgramNetworkError, HbMiniProgramSDKError, MiniProgramSDK, auth, cloud, createMiniProgramSDK, hbSDK as default, device, navigation, network, off, on, ready, share, storage, ui, user, viewport };

package/dist/miniapp-publish.cjs.js

@@ -2821,6 +2821,10 @@ const CREATE_USER_MINIPROGRAM_API_PATH = '/mall/developer/user_miniprogram/creat
 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 CREATE_USER_MINIPROGRAM_LEADERBOARD_API_PATH = '/mall/developer/user_miniprogram/leaderboard/create';
+const DETAIL_USER_MINIPROGRAM_LEADERBOARD_API_PATH = '/mall/developer/user_miniprogram/leaderboard/detail';
+const LIST_USER_MINIPROGRAM_LEADERBOARD_API_PATH = '/mall/developer/user_miniprogram/leaderboard/list';
+const DELETE_USER_MINIPROGRAM_LEADERBOARD_API_PATH = '/mall/developer/user_miniprogram/leaderboard/delete';
 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';
@@ -2901,10 +2905,14 @@ 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.CREATE_USER_MINIPROGRAM_LEADERBOARD_API_PATH = CREATE_USER_MINIPROGRAM_LEADERBOARD_API_PATH;
+exports.DELETE_USER_MINIPROGRAM_LEADERBOARD_API_PATH = DELETE_USER_MINIPROGRAM_LEADERBOARD_API_PATH;
 exports.DETAIL_USER_MINIPROGRAM_API_PATH = DETAIL_USER_MINIPROGRAM_API_PATH;
+exports.DETAIL_USER_MINIPROGRAM_LEADERBOARD_API_PATH = DETAIL_USER_MINIPROGRAM_LEADERBOARD_API_PATH;
 exports.DEVELOPER_ENTITY_LIST_API_PATH = DEVELOPER_ENTITY_LIST_API_PATH;
 exports.DEVELOPER_ENTITY_SWITCH_API_PATH = DEVELOPER_ENTITY_SWITCH_API_PATH;
 exports.LIST_USER_MINIPROGRAM_API_PATH = LIST_USER_MINIPROGRAM_API_PATH;
+exports.LIST_USER_MINIPROGRAM_LEADERBOARD_API_PATH = LIST_USER_MINIPROGRAM_LEADERBOARD_API_PATH;
 exports.LIST_USER_MINIPROGRAM_VERSION_API_PATH = LIST_USER_MINIPROGRAM_VERSION_API_PATH;
 exports.MINIAPP_UPLOAD_BATCH_SIZE = MINIAPP_UPLOAD_BATCH_SIZE;
 exports.MINIAPP_UPLOAD_SCOPE = MINIAPP_UPLOAD_SCOPE;

package/dist/miniapp-publish.esm.js

@@ -2819,6 +2819,10 @@ const CREATE_USER_MINIPROGRAM_API_PATH = '/mall/developer/user_miniprogram/creat
 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 CREATE_USER_MINIPROGRAM_LEADERBOARD_API_PATH = '/mall/developer/user_miniprogram/leaderboard/create';
+const DETAIL_USER_MINIPROGRAM_LEADERBOARD_API_PATH = '/mall/developer/user_miniprogram/leaderboard/detail';
+const LIST_USER_MINIPROGRAM_LEADERBOARD_API_PATH = '/mall/developer/user_miniprogram/leaderboard/list';
+const DELETE_USER_MINIPROGRAM_LEADERBOARD_API_PATH = '/mall/developer/user_miniprogram/leaderboard/delete';
 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';
@@ -2897,4 +2901,4 @@ function shouldUploadDistFile(relativePath) {
     return true;
 }
 
-export { ACTIVITY_UPLOAD_KEY_MAX_LENGTH, CREATE_USER_MINIPROGRAM_API_PATH, DETAIL_USER_MINIPROGRAM_API_PATH, DEVELOPER_ENTITY_LIST_API_PATH, DEVELOPER_ENTITY_SWITCH_API_PATH, LIST_USER_MINIPROGRAM_API_PATH, LIST_USER_MINIPROGRAM_VERSION_API_PATH, MINIAPP_UPLOAD_BATCH_SIZE, MINIAPP_UPLOAD_SCOPE, MINIAPP_UPLOAD_TOTAL_SIZE_LIMIT_BYTES, 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_SQUARE_DISPLAY_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, validateUploadTotalSize };
+export { ACTIVITY_UPLOAD_KEY_MAX_LENGTH, CREATE_USER_MINIPROGRAM_API_PATH, CREATE_USER_MINIPROGRAM_LEADERBOARD_API_PATH, DELETE_USER_MINIPROGRAM_LEADERBOARD_API_PATH, DETAIL_USER_MINIPROGRAM_API_PATH, DETAIL_USER_MINIPROGRAM_LEADERBOARD_API_PATH, DEVELOPER_ENTITY_LIST_API_PATH, DEVELOPER_ENTITY_SWITCH_API_PATH, LIST_USER_MINIPROGRAM_API_PATH, LIST_USER_MINIPROGRAM_LEADERBOARD_API_PATH, LIST_USER_MINIPROGRAM_VERSION_API_PATH, MINIAPP_UPLOAD_BATCH_SIZE, MINIAPP_UPLOAD_SCOPE, MINIAPP_UPLOAD_TOTAL_SIZE_LIMIT_BYTES, 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_SQUARE_DISPLAY_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, validateUploadTotalSize };

package/dist/protocol.cjs.js

@@ -115,6 +115,16 @@ const NAVIGATION_CLOSE_METHOD = 'navigation.close';
 const NAVIGATION_RELOAD_METHOD = 'navigation.reload';
 /** 打开黑盒 App 页面能力方法名。 */
 const NAVIGATION_OPEN_APP_PAGE_METHOD = 'navigation.openAppPage';
+/** 提交当前用户排行榜分数能力方法名。 */
+const CLOUD_LEADERBOARD_SUBMIT_METHOD = 'cloud.leaderboard.submit';
+/** 读取排行榜列表能力方法名。 */
+const CLOUD_LEADERBOARD_GET_LIST_METHOD = 'cloud.leaderboard.getList';
+/** 读取当前用户排行榜记录能力方法名。 */
+const CLOUD_LEADERBOARD_GET_CURRENT_USER_ENTRY_METHOD = 'cloud.leaderboard.getCurrentUserEntry';
+/** 删除当前用户排行榜记录能力方法名。 */
+const CLOUD_LEADERBOARD_DELETE_CURRENT_USER_ENTRY_METHOD = 'cloud.leaderboard.deleteCurrentUserEntry';
+/** 读取排行榜基础信息能力方法名。 */
+const CLOUD_LEADERBOARD_GET_INFO_METHOD = 'cloud.leaderboard.getInfo';
 /**
  * 小程序开放能力目录。
  *
@@ -276,9 +286,49 @@ const MINI_PROGRAM_PROTOCOL_CAPABILITIES = [
         permission: 'navigation.openAppPage',
         risk: 'medium',
     },
+    {
+        method: CLOUD_LEADERBOARD_SUBMIT_METHOD,
+        module: 'cloud',
+        capability: CLOUD_LEADERBOARD_SUBMIT_METHOD,
+        permission: 'cloud.leaderboard.write',
+        risk: 'medium',
+    },
+    {
+        method: CLOUD_LEADERBOARD_GET_LIST_METHOD,
+        module: 'cloud',
+        capability: CLOUD_LEADERBOARD_GET_LIST_METHOD,
+        permission: 'cloud.leaderboard.read',
+        risk: 'low',
+    },
+    {
+        method: CLOUD_LEADERBOARD_GET_CURRENT_USER_ENTRY_METHOD,
+        module: 'cloud',
+        capability: CLOUD_LEADERBOARD_GET_CURRENT_USER_ENTRY_METHOD,
+        permission: 'cloud.leaderboard.currentUserEntry.read',
+        risk: 'medium',
+    },
+    {
+        method: CLOUD_LEADERBOARD_DELETE_CURRENT_USER_ENTRY_METHOD,
+        module: 'cloud',
+        capability: CLOUD_LEADERBOARD_DELETE_CURRENT_USER_ENTRY_METHOD,
+        permission: 'cloud.leaderboard.currentUserEntry.delete',
+        risk: 'medium',
+    },
+    {
+        method: CLOUD_LEADERBOARD_GET_INFO_METHOD,
+        module: 'cloud',
+        capability: CLOUD_LEADERBOARD_GET_INFO_METHOD,
+        permission: 'cloud.leaderboard.info.read',
+        risk: 'low',
+    },
 ];
 
 exports.AUTH_LOGIN_METHOD = AUTH_LOGIN_METHOD;
+exports.CLOUD_LEADERBOARD_DELETE_CURRENT_USER_ENTRY_METHOD = CLOUD_LEADERBOARD_DELETE_CURRENT_USER_ENTRY_METHOD;
+exports.CLOUD_LEADERBOARD_GET_CURRENT_USER_ENTRY_METHOD = CLOUD_LEADERBOARD_GET_CURRENT_USER_ENTRY_METHOD;
+exports.CLOUD_LEADERBOARD_GET_INFO_METHOD = CLOUD_LEADERBOARD_GET_INFO_METHOD;
+exports.CLOUD_LEADERBOARD_GET_LIST_METHOD = CLOUD_LEADERBOARD_GET_LIST_METHOD;
+exports.CLOUD_LEADERBOARD_SUBMIT_METHOD = CLOUD_LEADERBOARD_SUBMIT_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;

package/dist/protocol.esm.js

@@ -113,6 +113,16 @@ const NAVIGATION_CLOSE_METHOD = 'navigation.close';
 const NAVIGATION_RELOAD_METHOD = 'navigation.reload';
 /** 打开黑盒 App 页面能力方法名。 */
 const NAVIGATION_OPEN_APP_PAGE_METHOD = 'navigation.openAppPage';
+/** 提交当前用户排行榜分数能力方法名。 */
+const CLOUD_LEADERBOARD_SUBMIT_METHOD = 'cloud.leaderboard.submit';
+/** 读取排行榜列表能力方法名。 */
+const CLOUD_LEADERBOARD_GET_LIST_METHOD = 'cloud.leaderboard.getList';
+/** 读取当前用户排行榜记录能力方法名。 */
+const CLOUD_LEADERBOARD_GET_CURRENT_USER_ENTRY_METHOD = 'cloud.leaderboard.getCurrentUserEntry';
+/** 删除当前用户排行榜记录能力方法名。 */
+const CLOUD_LEADERBOARD_DELETE_CURRENT_USER_ENTRY_METHOD = 'cloud.leaderboard.deleteCurrentUserEntry';
+/** 读取排行榜基础信息能力方法名。 */
+const CLOUD_LEADERBOARD_GET_INFO_METHOD = 'cloud.leaderboard.getInfo';
 /**
  * 小程序开放能力目录。
  *
@@ -274,6 +284,41 @@ const MINI_PROGRAM_PROTOCOL_CAPABILITIES = [
         permission: 'navigation.openAppPage',
         risk: 'medium',
     },
+    {
+        method: CLOUD_LEADERBOARD_SUBMIT_METHOD,
+        module: 'cloud',
+        capability: CLOUD_LEADERBOARD_SUBMIT_METHOD,
+        permission: 'cloud.leaderboard.write',
+        risk: 'medium',
+    },
+    {
+        method: CLOUD_LEADERBOARD_GET_LIST_METHOD,
+        module: 'cloud',
+        capability: CLOUD_LEADERBOARD_GET_LIST_METHOD,
+        permission: 'cloud.leaderboard.read',
+        risk: 'low',
+    },
+    {
+        method: CLOUD_LEADERBOARD_GET_CURRENT_USER_ENTRY_METHOD,
+        module: 'cloud',
+        capability: CLOUD_LEADERBOARD_GET_CURRENT_USER_ENTRY_METHOD,
+        permission: 'cloud.leaderboard.currentUserEntry.read',
+        risk: 'medium',
+    },
+    {
+        method: CLOUD_LEADERBOARD_DELETE_CURRENT_USER_ENTRY_METHOD,
+        module: 'cloud',
+        capability: CLOUD_LEADERBOARD_DELETE_CURRENT_USER_ENTRY_METHOD,
+        permission: 'cloud.leaderboard.currentUserEntry.delete',
+        risk: 'medium',
+    },
+    {
+        method: CLOUD_LEADERBOARD_GET_INFO_METHOD,
+        module: 'cloud',
+        capability: CLOUD_LEADERBOARD_GET_INFO_METHOD,
+        permission: 'cloud.leaderboard.info.read',
+        risk: 'low',
+    },
 ];
 
-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_OPEN_APP_PAGE_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_CURRENT_USER_DETAIL_METHOD, USER_GET_CURRENT_USER_PROFILE_METHOD, USER_GET_INFO_METHOD, USER_GET_PLATFORM_ACCOUNT_INFO_METHOD, USER_GET_PLATFORM_ACCOUNT_OVERVIEW_METHOD, USER_GET_STEAM_GAME_LIST_METHOD, VIEWPORT_GET_WINDOW_INFO_METHOD, VIEWPORT_SET_NAVIGATION_BAR_STYLE_METHOD, isMiniProgramBridgeMessage };
+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_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_OPEN_APP_PAGE_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_CURRENT_USER_DETAIL_METHOD, USER_GET_CURRENT_USER_PROFILE_METHOD, USER_GET_INFO_METHOD, USER_GET_PLATFORM_ACCOUNT_INFO_METHOD, USER_GET_PLATFORM_ACCOUNT_OVERVIEW_METHOD, USER_GET_STEAM_GAME_LIST_METHOD, VIEWPORT_GET_WINDOW_INFO_METHOD, VIEWPORT_SET_NAVIGATION_BAR_STYLE_METHOD, isMiniProgramBridgeMessage };

package/package.json

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

package/skill/references/api-protocol.md

@@ -38,6 +38,11 @@ export type {
 } from './protocol/types';
 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_SET_CLIPBOARD_METHOD,
   DEVICE_VIBRATE_METHOD,
   MINI_PROGRAM_PROTOCOL_CAPABILITIES,
@@ -72,6 +77,7 @@ export type {
   MiniProgramCapabilityResult,
   MiniProgramCapabilityResultMap,
   MiniProgramCapabilityRisk,
+  MiniProgramCloudMethod,
   MiniProgramNavigationMethod,
   MiniProgramNetworkMethod,
   MiniProgramShareMethod,
@@ -81,6 +87,20 @@ export type {
   MiniProgramViewportMethod,
 } from './protocol/capabilities';
 export type { LoginPayload, LoginResult } from './modules/auth';
+export type {
+  DeleteCurrentUserLeaderboardEntryPayload,
+  DeleteCurrentUserLeaderboardEntryResult,
+  GetCurrentUserLeaderboardEntryPayload,
+  GetCurrentUserLeaderboardEntryResult,
+  GetLeaderboardInfoPayload,
+  GetLeaderboardInfoResult,
+  GetLeaderboardListPayload,
+  GetLeaderboardListResult,
+  LeaderboardEntry,
+  LeaderboardOrder,
+  SubmitLeaderboardEntryPayload,
+  SubmitLeaderboardEntryResult,
+} from './modules/cloud';
 export type {
   GetCurrentUserDetailPayload,
   GetCurrentUserDetailResult,

package/skill/references/api-root.md

@@ -19,7 +19,7 @@
 ## Package metadata
 
 - Package: `@heybox/hb-sdk`
-- Version at generation time: `0.5.9`
+- Version at generation time: `0.5.11`
 - Public root export: `@heybox/hb-sdk`
 - Protocol export: `@heybox/hb-sdk/protocol`
 - Vite plugin export: `@heybox/hb-sdk/vite`
@@ -30,13 +30,29 @@
 export { createMiniProgramSDK, MiniProgramSDK } from './core/sdk';
 export { HbMiniProgramSDKError, HbMiniProgramNetworkError } from './core/errors';
 export type { MiniProgramSDKOptions } from './core/client';
-export { ready, on, off, auth, user, share, viewport, storage, network, ui, device, navigation } from './core/singleton';
+export { ready, on, off, auth, user, share, viewport, storage, network, ui, device, navigation, cloud } from './core/singleton';
 export type {
   MiniProgramEventHandler,
   MiniProgramEventName,
   MiniProgramEventPayloadMap,
 } from './protocol/types';
 export type { LoginPayload, LoginResult, MiniProgramAuthModule } from './modules/auth';
+export type {
+  DeleteCurrentUserLeaderboardEntryPayload,
+  DeleteCurrentUserLeaderboardEntryResult,
+  GetCurrentUserLeaderboardEntryPayload,
+  GetCurrentUserLeaderboardEntryResult,
+  GetLeaderboardInfoPayload,
+  GetLeaderboardInfoResult,
+  GetLeaderboardListPayload,
+  GetLeaderboardListResult,
+  LeaderboardEntry,
+  LeaderboardOrder,
+  MiniProgramCloudLeaderboardModule,
+  MiniProgramCloudModule,
+  SubmitLeaderboardEntryPayload,
+  SubmitLeaderboardEntryResult,
+} from './modules/cloud';
 export type {
   BasePlatformAccountInfo,
   CurrentUserAvatarConfig,
@@ -157,7 +173,7 @@ export type {
   ReloadResult,
 } from './modules/navigation';
 
-import { auth, device, navigation, network, off, on, ready, share, storage, ui, viewport, user } from './core/singleton';
+import { auth, cloud, device, navigation, network, off, on, ready, share, storage, ui, viewport, user } from './core/singleton';
 
 const hbSDK = {
   ready,
@@ -172,6 +188,7 @@ const hbSDK = {
   ui,
   device,
   navigation,
+  cloud,
 };
 
 export default hbSDK;
@@ -543,6 +560,49 @@ const { data } = await storage.getStorage<{ theme: string }>({
 
 storage key 只允许 1-128 位字母、数字、下划线和连字符。父容器会按小程序维度隔离 key，外部小程序不能读写黑盒客户端全局 storage。
 
+### 云端排行榜
+
+`cloud.leaderboard` 是平台托管的远端排行榜能力，不是本地 storage，也不是通用网络请求。小程序页面不能传 `userId`；宿主和服务端会按当前登录用户注入身份。
+
+```ts
+import { cloud } from '@heybox/hb-sdk';
+
+const entry = await cloud.leaderboard.submit({
+  key: 'cube_run_total',
+  score: 150,
+  extra: {
+    run: 2,
+  },
+});
+
+const list = await cloud.leaderboard.getList({
+  key: 'cube_run_total',
+  limit: 20,
+});
+
+const current = await cloud.leaderboard.getCurrentUserEntry({
+  key: 'cube_run_total',
+});
+
+await cloud.leaderboard.deleteCurrentUserEntry({
+  key: 'cube_run_total',
+});
+
+const info = await cloud.leaderboard.getInfo({
+  key: 'cube_run_total',
+});
+```
+
+排行榜需要先通过管理端创建；管理端创建成功时服务端会同步准备记录集合，之后运行时可立即读写。`key` 不传时服务端会查找当前小程序已创建的 `default` 榜单，不存在时会拒绝请求，不会自动创建空榜。单个小程序最多创建 3 个排行榜，超出时服务端返回 `LEADERBOARD_LIMIT_EXCEEDED`。
+
+`order` 在创建榜单时固定，`desc` 表示分数越大越靠前，`asc` 表示分数越小越靠前。同分时按更早更新时间优先，再按 `userId` 稳定排序。`rankLimit` 为 `0` 表示列表不限制展示名次；大于 `0` 时限制 `getList()` 展示范围。当前用户记录仍会保留，但 `submit()` 和 `getCurrentUserEntry()` 只精确计算前 5000 名，且会优先受 `rankLimit` 限制；超过 `min(rankLimit, 5000)`（`rankLimit=0` 时按 5000）时返回 `ranked: false`、`rank: 0`。
+
+`submit()` 只在本次 `score` 更优时更新当前用户记录，并返回最终 `LeaderboardEntry`；如果分数不更优，`extra` 也不会更新。同一用户同一榜单的并发提交由服务端串行保护，锁冲突时返回 `LEADERBOARD_SUBMIT_LOCKED`，业务可稍后重试。首次提交未传 `extra` 会保存为空对象；已有记录提交更优分数但未传 `extra` 时会保留旧 `extra`，需要清空时请显式传 `{}`。`score` 必须是有限安全数字，绝对值不能超过 `Number.MAX_SAFE_INTEGER`；`extra` 必须是 JSON 对象，序列化后的 UTF-8 长度不能超过 2048 字节。
+
+`getList()` 默认 20 条、最多 100 条；`cursor` 是服务端返回的不透明分页游标，只能把上一页返回的值原样传给下一次 `getList()`，不要解析、拼接或自行构造。非法 cursor 会按参数错误拒绝。服务端会短暂缓存榜单头部结果，当前缓存前 500 条或 `rankLimit` 范围内记录，`submit()`、`deleteCurrentUserEntry()` 和管理端删榜会触发缓存失效；业务不要依赖毫秒级实时刷新。`getInfo()` 返回 `key/order/rankLimit`，其中 `rankLimit` 不包含当前用户记录的 5000 名精确排名计算上限。
+
+排行榜后端错误会保留为 `HbMiniProgramSDKError.code`，常见值包括 `LEADERBOARD_DEFAULT_NOT_FOUND`、`LEADERBOARD_LIMIT_EXCEEDED`、`LEADERBOARD_SUBMIT_LOCKED`、`LEADERBOARD_TABLE_NOT_READY`、`InvalidArgument`、`NotFound`、`ResourceExhausted`、`Unauthenticated`。业务可以按 `code` 区分未建榜、并发提交、数据表配置异常、参数错误、容量限制和未登录等场景。
+
 ### 网络请求
 
 `network.request()` 提供窄化的 axios-like 接口。SDK 只接受公开请求字段，真实请求由父容器运行时映射到宿主网络能力。

package/skill/skill.json

@@ -1,11 +1,11 @@
 {
   "name": "hb-sdk",
-  "skillVersion": "0.5.9+skill.02be68ce07ce",
+  "skillVersion": "0.5.11+skill.20c209340580",
   "sdk": {
     "package": "@heybox/hb-sdk",
-    "version": "0.5.9",
-    "compatibility": "0.5.9"
+    "version": "0.5.11",
+    "compatibility": "0.5.11"
   },
   "source": "https://open.xiaoheihe.cn/agent-skills/hb-sdk",
-  "integrity": "sha256-02be68ce07ce1cf0ecba354d764a47977e4fc3c189b5e4aed3cee1f844fddfd4"
+  "integrity": "sha256-20c209340580ee5507bb72eb8cd044693b29e109472e93fc3d8302a53b4770d2"
 }

package/types/core/client.d.ts

@@ -18,7 +18,7 @@ export interface MiniProgramSDKOptions {
     /** 精准 postMessage 目标 origin；未传时尝试推断，失败则回退为 `*`。 */
     targetOrigin?: string;
 }
-type MiniProgramRequesterArgs<Method extends MiniProgramBridgeMethod> = MiniProgramCapabilityPayload<Method> extends void ? [payload?: MiniProgramCapabilityPayload<Method>] : [payload: MiniProgramCapabilityPayload<Method>];
+type MiniProgramRequesterArgs<Method extends MiniProgramBridgeMethod> = MiniProgramCapabilityPayload<Method> extends void ? [payload?: MiniProgramCapabilityPayload<Method>] : undefined extends MiniProgramCapabilityPayload<Method> ? [payload?: MiniProgramCapabilityPayload<Method>] : [payload: MiniProgramCapabilityPayload<Method>];
 /** 模块 API 发起请求所需的最小能力。 */
 export interface MiniProgramRequester {
     /** 向父容器调用指定开放能力。 */

package/types/core/sdk.d.ts

@@ -1,5 +1,6 @@
 import { type MiniProgramSDKOptions } from './client';
 import { type MiniProgramAuthModule } from '../modules/auth';
+import { type MiniProgramCloudModule } from '../modules/cloud';
 import { type MiniProgramShareModule } from '../modules/share';
 import { type MiniProgramStorageModule } from '../modules/storage';
 import { type MiniProgramNetworkModule } from '../modules/network';
@@ -50,6 +51,8 @@ export declare class MiniProgramSDK {
     readonly device: MiniProgramDeviceModule;
     /** 导航与容器控制相关开放能力。 */
     readonly navigation: MiniProgramNavigationModule;
+    /** 云端数据相关开放能力。 */
+    readonly cloud: MiniProgramCloudModule;
     constructor(options?: MiniProgramSDKOptions);
     /**
      * 等待 SDK 与父容器完成握手。

package/types/core/singleton.d.ts

@@ -1,4 +1,5 @@
 import type { MiniProgramAuthModule } from '../modules/auth';
+import type { MiniProgramCloudModule } from '../modules/cloud';
 import type { MiniProgramShareModule } from '../modules/share';
 import type { MiniProgramStorageModule } from '../modules/storage';
 import type { MiniProgramNetworkModule } from '../modules/network';
@@ -49,5 +50,7 @@ export declare const ui: MiniProgramUiModule;
 export declare const device: MiniProgramDeviceModule;
 /** 默认 SDK 实例的 navigation 模块。 */
 export declare const navigation: MiniProgramNavigationModule;
+/** 默认 SDK 实例的 cloud 模块。 */
+export declare const cloud: MiniProgramCloudModule;
 /** 重置默认 SDK 实例，仅用于测试。 */
 export declare function resetDefaultSDKForTest(): void;

package/types/index.d.ts

@@ -1,9 +1,10 @@
 export { createMiniProgramSDK, MiniProgramSDK } from './core/sdk';
 export { HbMiniProgramSDKError, HbMiniProgramNetworkError } from './core/errors';
 export type { MiniProgramSDKOptions } from './core/client';
-export { ready, on, off, auth, user, share, viewport, storage, network, ui, device, navigation } from './core/singleton';
+export { ready, on, off, auth, user, share, viewport, storage, network, ui, device, navigation, cloud } from './core/singleton';
 export type { MiniProgramEventHandler, MiniProgramEventName, MiniProgramEventPayloadMap, } from './protocol/types';
 export type { LoginPayload, LoginResult, MiniProgramAuthModule } from './modules/auth';
+export type { DeleteCurrentUserLeaderboardEntryPayload, DeleteCurrentUserLeaderboardEntryResult, GetCurrentUserLeaderboardEntryPayload, GetCurrentUserLeaderboardEntryResult, GetLeaderboardInfoPayload, GetLeaderboardInfoResult, GetLeaderboardListPayload, GetLeaderboardListResult, LeaderboardEntry, LeaderboardOrder, MiniProgramCloudLeaderboardModule, MiniProgramCloudModule, SubmitLeaderboardEntryPayload, SubmitLeaderboardEntryResult, } from './modules/cloud';
 export type { BasePlatformAccountInfo, CurrentUserAvatarConfig, CurrentUserAvatarDecoration, CurrentUserBbsInfo, CurrentUserDetail, CurrentUserLevelInfo, CurrentUserMedal, CurrentUserProfile, EpicPlatformAccountInfo, GetCurrentUserDetailPayload, GetCurrentUserDetailResult, GetCurrentUserProfilePayload, GetCurrentUserProfileResult, GetPlatformAccountInfoPayload, GetPlatformAccountInfoResult, GetPlatformAccountOverviewPayload, GetPlatformAccountOverviewResult, GetSteamGameListOptions, GetSteamGameListPayload, GetSteamGameListResult, GetUserInfoPayload, GetUserInfoResult, MiniProgramUserInfo, MiniProgramUserInfoResult, MiniProgramUserModule, MobilePlatformAccountInfo, PcHardwareAccountInfo, PlatformAccountInfoMap, PlatformAccountOverview, PlatformAccountResult, PlatformAccountType, PlatformStatItem, PsnPlatformAccountInfo, SteamGameListData, SteamGameListItem, SteamGameListSort, SteamGamePrice, SteamPlatformAccountInfo, SwitchPlatformAccountInfo, UserScopedResult, XboxPlatformAccountInfo, } from './modules/user';
 export type { MiniProgramScreenshotOptions, MiniProgramScreenshotRect, MiniProgramShareChannel, MiniProgramShareModule, MiniProgramShowShareMenuOptions, ScreenshotPayload, ScreenshotResult, ShowShareMenuPayload, ShowShareMenuResult, } from './modules/share';
 export type { GetWindowInfoPayload, GetWindowInfoResult, MiniProgramNavigationBarForegroundStyle, MiniProgramSafeArea, MiniProgramSetNavigationBarStyleOptions, MiniProgramViewportModule, MiniProgramWindowInfoResult, SetNavigationBarStylePayload, SetNavigationBarStyleResult, } from './modules/viewport';
@@ -26,5 +27,6 @@ declare const hbSDK: {
     ui: import(".").MiniProgramUiModule;
     device: import(".").MiniProgramDeviceModule;
     navigation: import(".").MiniProgramNavigationModule;
+    cloud: import(".").MiniProgramCloudModule;
 };
 export default hbSDK;

package/types/miniapp-publish/index.d.ts

@@ -10,6 +10,10 @@ export declare const CREATE_USER_MINIPROGRAM_API_PATH = "/mall/developer/user_mi
 export declare const DETAIL_USER_MINIPROGRAM_API_PATH = "/mall/developer/user_miniprogram/detail";
 export declare const USER_MINIPROGRAM_PREVIEW_ALLOWLIST_API_PATH = "/mall/developer/user_miniprogram/preview_allowlist";
 export declare const UPDATE_USER_MINIPROGRAM_PREVIEW_ALLOWLIST_API_PATH = "/mall/developer/user_miniprogram/preview_allowlist/update";
+export declare const CREATE_USER_MINIPROGRAM_LEADERBOARD_API_PATH = "/mall/developer/user_miniprogram/leaderboard/create";
+export declare const DETAIL_USER_MINIPROGRAM_LEADERBOARD_API_PATH = "/mall/developer/user_miniprogram/leaderboard/detail";
+export declare const LIST_USER_MINIPROGRAM_LEADERBOARD_API_PATH = "/mall/developer/user_miniprogram/leaderboard/list";
+export declare const DELETE_USER_MINIPROGRAM_LEADERBOARD_API_PATH = "/mall/developer/user_miniprogram/leaderboard/delete";
 export declare const PRECHECK_USER_MINIPROGRAM_VERSION_API_PATH = "/mall/developer/user_miniprogram/version/precheck";
 export declare const SUBMIT_USER_MINIPROGRAM_AUDIT_API_PATH = "/mall/developer/user_miniprogram/version/submit_audit";
 export declare const USER_MINIPROGRAM_VERSION_PREVIEW_INFO_API_PATH = "/mall/developer/user_miniprogram/version/preview_info";