@heybox/hb-sdk 0.5.10 → 0.5.12

package/dist/index.cjs.js

@@ -211,6 +211,8 @@ class MiniProgramBridgeClient {
     readyTimer;
     handshakeRetryTimer;
     destroyed = false;
+    runtimeUnavailable = false;
+    runtimeUnavailableError;
     constructor(options = {}) {
         this.timeout = options.timeout || DEFAULT_TIMEOUT;
         this.selfWindow = options.selfWindow || getGlobalWindow();
@@ -224,15 +226,14 @@ class MiniProgramBridgeClient {
             this.rejectReady = reject;
         });
         this.readyPromise.catch(() => undefined);
+        this.ensureStarted();
     }
     /** 等待父容器握手完成。 */
     ready() {
-        this.ensureStarted();
         return this.readyPromise;
     }
     /** 注册小程序事件监听。 */
     on(eventName, handler) {
-        this.ensureStarted();
         return this.eventBus.on(eventName, handler);
     }
     /** 移除小程序事件监听。 */
@@ -241,7 +242,19 @@ class MiniProgramBridgeClient {
     }
     /** 调用父容器开放能力。 */
     async request(method, ...args) {
+        if (this.destroyed) {
+            throw createSDKError('SDK_DESTROYED', '小程序 SDK 已销毁');
+        }
+        if (this.runtimeUnavailable) {
+            throw this.getRuntimeUnavailableError();
+        }
         await this.ready();
+        if (this.destroyed) {
+            throw createSDKError('SDK_DESTROYED', '小程序 SDK 已销毁');
+        }
+        if (this.runtimeUnavailable) {
+            throw this.getRuntimeUnavailableError();
+        }
         const payload = args[0];
         const id = createMessageId();
         const message = {
@@ -286,6 +299,10 @@ class MiniProgramBridgeClient {
             this.failReady(createSDKError('SDK_DESTROYED', '小程序 SDK 已销毁'));
             return;
         }
+        if (this.runtimeUnavailable) {
+            this.failReady(this.getRuntimeUnavailableError());
+            return;
+        }
         if (this.started) {
             return;
         }
@@ -305,7 +322,14 @@ class MiniProgramBridgeClient {
         try {
             this.postHandshake();
             this.handshakeRetryTimer = setInterval(() => {
-                this.postHandshake();
+                try {
+                    this.postHandshake();
+                }
+                catch (error) {
+                    this.failReady(error instanceof HbMiniProgramSDKError
+                        ? error
+                        : createSDKError('HANDSHAKE_FAILED', '小程序沙盒握手发送失败', error));
+                }
             }, HANDSHAKE_RETRY_INTERVAL);
         }
         catch (error) {
@@ -348,7 +372,10 @@ class MiniProgramBridgeClient {
     }
     handleEvent(message) {
         const eventName = message.method;
-        if (eventName === 'ready') {
+        if (eventName === 'unload') {
+            this.markRuntimeUnavailable();
+        }
+        else if (eventName === 'ready' && !this.runtimeUnavailable) {
             this.resolveReadyOnce();
         }
         this.eventBus.emit(eventName, message.payload);
@@ -401,6 +428,22 @@ class MiniProgramBridgeClient {
             this.handshakeRetryTimer = undefined;
         }
     }
+    markRuntimeUnavailable() {
+        if (this.runtimeUnavailable) {
+            return;
+        }
+        const error = this.getRuntimeUnavailableError();
+        this.runtimeUnavailable = true;
+        this.clearReadyTimers();
+        this.failReady(error);
+        this.rejectAllPending(error);
+    }
+    getRuntimeUnavailableError() {
+        if (!this.runtimeUnavailableError) {
+            this.runtimeUnavailableError = createSDKError('RUNTIME_UNAVAILABLE', '小程序运行时已卸载');
+        }
+        return this.runtimeUnavailableError;
+    }
     rejectAllPending(error) {
         this.pendingRequests.forEach(pending => {
             clearTimeout(pending.timer);
@@ -499,6 +542,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 +578,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 +1044,8 @@ class MiniProgramSDK {
     device;
     /** 导航与容器控制相关开放能力。 */
     navigation;
+    /** 云端数据相关开放能力。 */
+    cloud;
     constructor(options) {
         this.client = new MiniProgramBridgeClient(options);
         this.auth = createAuthModule(this.client);
@@ -990,6 +1057,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 +1205,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 +1229,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

@@ -207,6 +207,8 @@ class MiniProgramBridgeClient {
     readyTimer;
     handshakeRetryTimer;
     destroyed = false;
+    runtimeUnavailable = false;
+    runtimeUnavailableError;
     constructor(options = {}) {
         this.timeout = options.timeout || DEFAULT_TIMEOUT;
         this.selfWindow = options.selfWindow || getGlobalWindow();
@@ -220,15 +222,14 @@ class MiniProgramBridgeClient {
             this.rejectReady = reject;
         });
         this.readyPromise.catch(() => undefined);
+        this.ensureStarted();
     }
     /** 等待父容器握手完成。 */
     ready() {
-        this.ensureStarted();
         return this.readyPromise;
     }
     /** 注册小程序事件监听。 */
     on(eventName, handler) {
-        this.ensureStarted();
         return this.eventBus.on(eventName, handler);
     }
     /** 移除小程序事件监听。 */
@@ -237,7 +238,19 @@ class MiniProgramBridgeClient {
     }
     /** 调用父容器开放能力。 */
     async request(method, ...args) {
+        if (this.destroyed) {
+            throw createSDKError('SDK_DESTROYED', '小程序 SDK 已销毁');
+        }
+        if (this.runtimeUnavailable) {
+            throw this.getRuntimeUnavailableError();
+        }
         await this.ready();
+        if (this.destroyed) {
+            throw createSDKError('SDK_DESTROYED', '小程序 SDK 已销毁');
+        }
+        if (this.runtimeUnavailable) {
+            throw this.getRuntimeUnavailableError();
+        }
         const payload = args[0];
         const id = createMessageId();
         const message = {
@@ -282,6 +295,10 @@ class MiniProgramBridgeClient {
             this.failReady(createSDKError('SDK_DESTROYED', '小程序 SDK 已销毁'));
             return;
         }
+        if (this.runtimeUnavailable) {
+            this.failReady(this.getRuntimeUnavailableError());
+            return;
+        }
         if (this.started) {
             return;
         }
@@ -301,7 +318,14 @@ class MiniProgramBridgeClient {
         try {
             this.postHandshake();
             this.handshakeRetryTimer = setInterval(() => {
-                this.postHandshake();
+                try {
+                    this.postHandshake();
+                }
+                catch (error) {
+                    this.failReady(error instanceof HbMiniProgramSDKError
+                        ? error
+                        : createSDKError('HANDSHAKE_FAILED', '小程序沙盒握手发送失败', error));
+                }
             }, HANDSHAKE_RETRY_INTERVAL);
         }
         catch (error) {
@@ -344,7 +368,10 @@ class MiniProgramBridgeClient {
     }
     handleEvent(message) {
         const eventName = message.method;
-        if (eventName === 'ready') {
+        if (eventName === 'unload') {
+            this.markRuntimeUnavailable();
+        }
+        else if (eventName === 'ready' && !this.runtimeUnavailable) {
             this.resolveReadyOnce();
         }
         this.eventBus.emit(eventName, message.payload);
@@ -397,6 +424,22 @@ class MiniProgramBridgeClient {
             this.handshakeRetryTimer = undefined;
         }
     }
+    markRuntimeUnavailable() {
+        if (this.runtimeUnavailable) {
+            return;
+        }
+        const error = this.getRuntimeUnavailableError();
+        this.runtimeUnavailable = true;
+        this.clearReadyTimers();
+        this.failReady(error);
+        this.rejectAllPending(error);
+    }
+    getRuntimeUnavailableError() {
+        if (!this.runtimeUnavailableError) {
+            this.runtimeUnavailableError = createSDKError('RUNTIME_UNAVAILABLE', '小程序运行时已卸载');
+        }
+        return this.runtimeUnavailableError;
+    }
     rejectAllPending(error) {
         this.pendingRequests.forEach(pending => {
             clearTimeout(pending.timer);
@@ -495,6 +538,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 +574,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 +1040,8 @@ class MiniProgramSDK {
     device;
     /** 导航与容器控制相关开放能力。 */
     navigation;
+    /** 云端数据相关开放能力。 */
+    cloud;
     constructor(options) {
         this.client = new MiniProgramBridgeClient(options);
         this.auth = createAuthModule(this.client);
@@ -986,6 +1053,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 +1201,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 +1225,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.12",
   "description": "",
   "exports": {
     ".": {
@@ -116,9 +116,7 @@
     "build:templates": "node scripts/copy-cli-templates.cjs",
     "build:types": "tsc -p tsconfig.dts.json",
     "check:boundary": "node scripts/check-boundary.cjs",
-    "check:docs-sync": "node scripts/check-docs-sync.cjs",
-    "sync:agent-skills-payload": "node skill/scripts/sync-agent-skills-payload.mjs",
-    "check:agent-skills-payload": "node skill/scripts/sync-agent-skills-payload.mjs --check",
+    "check:docs-sync": "pnpm -w exec hbexec hb-sdk check",
     "clean": "rimraf ./dist && rimraf ./types",
     "test:unit": "NODE_OPTIONS='--conditions=heybox' vitest run",
     "test:unit:coverage": "NODE_OPTIONS='--conditions=heybox' vitest run --coverage",

package/skill/SKILL.md

@@ -118,6 +118,7 @@ For host/runtime/protocol-maintenance code:
    - `pnpm --filter @heybox/hb-sdk run check:boundary`
    - `pnpm --filter @heybox/hb-sdk run test:unit`
    - Verify `dist/cli.cjs` does not have any `require('cos-nodejs-sdk-v5')` left after `build:cli`; the boundary check enforces this automatically.
-8. Verify public payload sync before publishing:
-   - `pnpm --filter @heybox-spa/open run sync:agent-skills`
-   - `pnpm --filter @heybox-spa/open run check:agent-skills`
+8. Verify the canonical payload before publishing:
+   - `pnpm exec hbexec hb-sdk sync`
+   - `pnpm exec hbexec hb-sdk check`
+   - For a release artifact, run `pnpm exec hbexec hb-sdk sync --out-dir <payload-dir>` and then `pnpm exec hbexec hb-sdk check-artifact --artifact-dir <payload-dir>`.

package/skill/references/api-protocol.md

@@ -6,7 +6,7 @@
 
 - packages/hb-sdk/src/protocol.ts
 - packages/hb-sdk/README.md
-- apps/h5/docs/hb_sdk/src/.vuepress/public/llms/reference/README.md
+- apps/docs/hb-sdk/reference/index.md
 
 ## Contents
 
@@ -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,
@@ -177,16 +197,16 @@ export type {
 
 # Reference
 
-Reference 由 `packages/hb-sdk` 的公开导出与源码注释自动生成，不重复 Guide 的接入流程。
+Reference 由 `@heybox/hb-sdk` 的公开导出与源码注释自动生成，不重复 Guide 的接入流程。
 
 | 导出面 | 说明 |
 | --- | --- |
-| [Root API](./root/README.md) | 来自 `src/index.ts` 的默认导出、命名导出与公开能力。 |
-| [Protocol API](./protocol/README.md) | 来自 `src/protocol.ts` 的协议常量、消息类型与 method 契约。 |
+| [Root API](./root/) | 来自 `src/index.ts` 的默认导出、命名导出与公开能力。 |
+| [Protocol API](./protocol/) | 来自 `src/protocol.ts` 的协议常量、消息类型与 method 契约。 |
 
 ## 查询建议
 
-- 想查业务接入路径：先看 [Guide](../guide/README.md)。
+- 想查业务接入路径：先看 [Guide](../guide/)。
 - 想查导出符号：从 Root API 或 Protocol API 进入对应分类页。
 - 想看场景化用法：优先看 Guide / Recipes 页面中的“进一步阅读”。
 
@@ -194,5 +214,5 @@ Reference 由 `packages/hb-sdk` 的公开导出与源码注释自动生成，不
 
 | 导出面 | Classes | Functions | Interfaces | Types | Constants |
 | --- | ---: | ---: | ---: | ---: | ---: |
-| Root API | 3 | 4 | 53 | 45 | 3 |
-| Protocol API | 0 | 1 | 30 | 57 | 26 |
+| Root API | 3 | 4 | 67 | 57 | 4 |
+| Protocol API | 0 | 1 | 39 | 66 | 32 |