@heybox/hb-sdk 0.5.10 → 0.5.12
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +99 -55
- package/dist/cli-chunks/{create-D1W2pkHZ.cjs → create-Ba353lSg.cjs} +1 -1
- package/dist/cli-chunks/{dev-DwbE-c1x.cjs → dev-BhPFNef-.cjs} +1 -1
- package/dist/cli-chunks/{doctor-Bx71WFjM.cjs → doctor-CP4kwgAn.cjs} +1 -1
- package/dist/cli-chunks/{index-D5bZjpH9.cjs → index-BfpHPA6k.cjs} +2 -2
- package/dist/cli-chunks/{index-BBatNb1l.cjs → index-DeamIV1-.cjs} +57 -13
- package/dist/cli-chunks/{login-BX0YmVyi.cjs → login-DMNap0-y.cjs} +2 -2
- package/dist/cli-chunks/{remote-YDmSxyYi.cjs → remote-gXUjRvGB.cjs} +117 -3
- package/dist/cli-chunks/{session-BxZBXDZ-.cjs → session-D5Vf-fNZ.cjs} +1 -1
- package/dist/cli.cjs +1 -1
- package/dist/devtools/mock-host/main.js +590 -0
- package/dist/index.cjs.js +84 -4
- package/dist/index.esm.js +84 -5
- package/dist/miniapp-publish.cjs.js +8 -0
- package/dist/miniapp-publish.esm.js +5 -1
- package/dist/protocol.cjs.js +50 -0
- package/dist/protocol.esm.js +46 -1
- package/package.json +2 -4
- package/skill/SKILL.md +4 -3
- package/skill/references/api-protocol.md +27 -7
- package/skill/references/api-root.md +64 -4
- package/skill/references/cli.md +3 -3
- package/skill/references/examples.md +2 -1
- package/skill/references/llms-index.md +16 -37
- package/skill/references/recipes.md +9 -9
- package/skill/references/safety-boundaries.md +3 -2
- package/skill/scripts/sync-references.mjs +35 -25
- package/skill/skill.json +4 -4
- package/types/core/client.d.ts +5 -1
- package/types/core/sdk.d.ts +3 -0
- package/types/core/singleton.d.ts +3 -0
- package/types/index.d.ts +3 -1
- package/types/miniapp-publish/index.d.ts +4 -0
- package/types/modules/cloud/index.d.ts +100 -0
- package/types/protocol/capabilities.d.ts +55 -2
- package/types/protocol.d.ts +3 -2
|
@@ -1,4 +1,5 @@
|
|
|
1
1
|
import type { LoginPayload, LoginResult } from '../modules/auth';
|
|
2
|
+
import type { DeleteCurrentUserLeaderboardEntryPayload, DeleteCurrentUserLeaderboardEntryResult, GetCurrentUserLeaderboardEntryPayload, GetCurrentUserLeaderboardEntryResult, GetLeaderboardInfoPayload, GetLeaderboardInfoResult, GetLeaderboardListPayload, GetLeaderboardListResult, SubmitLeaderboardEntryPayload, SubmitLeaderboardEntryResult } from '../modules/cloud';
|
|
2
3
|
import type { SetClipboardPayload, SetClipboardResult, VibratePayload, VibrateResult } from '../modules/device';
|
|
3
4
|
import type { ClosePayload, CloseResult, OpenAppPagePayload, OpenAppPageResult, ReloadPayload, ReloadResult } from '../modules/navigation';
|
|
4
5
|
import type { NetworkRequestPayload, NetworkResponsePayload } from '../modules/network';
|
|
@@ -96,6 +97,16 @@ export declare const NAVIGATION_CLOSE_METHOD: "navigation.close";
|
|
|
96
97
|
export declare const NAVIGATION_RELOAD_METHOD: "navigation.reload";
|
|
97
98
|
/** 打开黑盒 App 页面能力方法名。 */
|
|
98
99
|
export declare const NAVIGATION_OPEN_APP_PAGE_METHOD: "navigation.openAppPage";
|
|
100
|
+
/** 提交当前用户排行榜分数能力方法名。 */
|
|
101
|
+
export declare const CLOUD_LEADERBOARD_SUBMIT_METHOD: "cloud.leaderboard.submit";
|
|
102
|
+
/** 读取排行榜列表能力方法名。 */
|
|
103
|
+
export declare const CLOUD_LEADERBOARD_GET_LIST_METHOD: "cloud.leaderboard.getList";
|
|
104
|
+
/** 读取当前用户排行榜记录能力方法名。 */
|
|
105
|
+
export declare const CLOUD_LEADERBOARD_GET_CURRENT_USER_ENTRY_METHOD: "cloud.leaderboard.getCurrentUserEntry";
|
|
106
|
+
/** 删除当前用户排行榜记录能力方法名。 */
|
|
107
|
+
export declare const CLOUD_LEADERBOARD_DELETE_CURRENT_USER_ENTRY_METHOD: "cloud.leaderboard.deleteCurrentUserEntry";
|
|
108
|
+
/** 读取排行榜基础信息能力方法名。 */
|
|
109
|
+
export declare const CLOUD_LEADERBOARD_GET_INFO_METHOD: "cloud.leaderboard.getInfo";
|
|
99
110
|
/** 授权模块开放的方法名。 */
|
|
100
111
|
export type MiniProgramAuthMethod = typeof AUTH_LOGIN_METHOD;
|
|
101
112
|
/** 用户模块开放的方法名。 */
|
|
@@ -114,10 +125,12 @@ export type MiniProgramUiMethod = typeof UI_SHOW_TOAST_METHOD | typeof UI_SHOW_L
|
|
|
114
125
|
export type MiniProgramDeviceMethod = typeof DEVICE_VIBRATE_METHOD | typeof DEVICE_SET_CLIPBOARD_METHOD;
|
|
115
126
|
/** Navigation 模块开放的方法名。 */
|
|
116
127
|
export type MiniProgramNavigationMethod = typeof NAVIGATION_CLOSE_METHOD | typeof NAVIGATION_RELOAD_METHOD | typeof NAVIGATION_OPEN_APP_PAGE_METHOD;
|
|
128
|
+
/** Cloud 模块开放的方法名。 */
|
|
129
|
+
export type MiniProgramCloudMethod = typeof CLOUD_LEADERBOARD_SUBMIT_METHOD | typeof CLOUD_LEADERBOARD_GET_LIST_METHOD | typeof CLOUD_LEADERBOARD_GET_CURRENT_USER_ENTRY_METHOD | typeof CLOUD_LEADERBOARD_DELETE_CURRENT_USER_ENTRY_METHOD | typeof CLOUD_LEADERBOARD_GET_INFO_METHOD;
|
|
117
130
|
/** 父容器开放给小程序调用的 bridge method。 */
|
|
118
|
-
export type MiniProgramBridgeMethod = MiniProgramAuthMethod | MiniProgramUserMethod | MiniProgramShareMethod | MiniProgramViewportMethod | MiniProgramStorageMethod | MiniProgramNetworkMethod | MiniProgramUiMethod | MiniProgramDeviceMethod | MiniProgramNavigationMethod;
|
|
131
|
+
export type MiniProgramBridgeMethod = MiniProgramAuthMethod | MiniProgramUserMethod | MiniProgramShareMethod | MiniProgramViewportMethod | MiniProgramStorageMethod | MiniProgramNetworkMethod | MiniProgramUiMethod | MiniProgramDeviceMethod | MiniProgramNavigationMethod | MiniProgramCloudMethod;
|
|
119
132
|
/** 小程序开放能力所属模块。 */
|
|
120
|
-
export type MiniProgramCapabilityModule = 'auth' | 'user' | 'share' | 'viewport' | 'storage' | 'network' | 'ui' | 'device' | 'navigation';
|
|
133
|
+
export type MiniProgramCapabilityModule = 'auth' | 'user' | 'share' | 'viewport' | 'storage' | 'network' | 'ui' | 'device' | 'navigation' | 'cloud';
|
|
121
134
|
/** 小程序开放能力风险级别,用于权限、审计和灰度策略。 */
|
|
122
135
|
export type MiniProgramCapabilityRisk = 'low' | 'medium' | 'high';
|
|
123
136
|
/**
|
|
@@ -277,6 +290,36 @@ export declare const MINI_PROGRAM_PROTOCOL_CAPABILITIES: readonly [{
|
|
|
277
290
|
readonly capability: "navigation.openAppPage";
|
|
278
291
|
readonly permission: "navigation.openAppPage";
|
|
279
292
|
readonly risk: "medium";
|
|
293
|
+
}, {
|
|
294
|
+
readonly method: "cloud.leaderboard.submit";
|
|
295
|
+
readonly module: "cloud";
|
|
296
|
+
readonly capability: "cloud.leaderboard.submit";
|
|
297
|
+
readonly permission: "cloud.leaderboard.write";
|
|
298
|
+
readonly risk: "medium";
|
|
299
|
+
}, {
|
|
300
|
+
readonly method: "cloud.leaderboard.getList";
|
|
301
|
+
readonly module: "cloud";
|
|
302
|
+
readonly capability: "cloud.leaderboard.getList";
|
|
303
|
+
readonly permission: "cloud.leaderboard.read";
|
|
304
|
+
readonly risk: "low";
|
|
305
|
+
}, {
|
|
306
|
+
readonly method: "cloud.leaderboard.getCurrentUserEntry";
|
|
307
|
+
readonly module: "cloud";
|
|
308
|
+
readonly capability: "cloud.leaderboard.getCurrentUserEntry";
|
|
309
|
+
readonly permission: "cloud.leaderboard.currentUserEntry.read";
|
|
310
|
+
readonly risk: "medium";
|
|
311
|
+
}, {
|
|
312
|
+
readonly method: "cloud.leaderboard.deleteCurrentUserEntry";
|
|
313
|
+
readonly module: "cloud";
|
|
314
|
+
readonly capability: "cloud.leaderboard.deleteCurrentUserEntry";
|
|
315
|
+
readonly permission: "cloud.leaderboard.currentUserEntry.delete";
|
|
316
|
+
readonly risk: "medium";
|
|
317
|
+
}, {
|
|
318
|
+
readonly method: "cloud.leaderboard.getInfo";
|
|
319
|
+
readonly module: "cloud";
|
|
320
|
+
readonly capability: "cloud.leaderboard.getInfo";
|
|
321
|
+
readonly permission: "cloud.leaderboard.info.read";
|
|
322
|
+
readonly risk: "low";
|
|
280
323
|
}];
|
|
281
324
|
/** bridge method 到请求 payload 的映射。 */
|
|
282
325
|
export interface MiniProgramCapabilityPayloadMap {
|
|
@@ -302,6 +345,11 @@ export interface MiniProgramCapabilityPayloadMap {
|
|
|
302
345
|
[NAVIGATION_CLOSE_METHOD]: ClosePayload;
|
|
303
346
|
[NAVIGATION_RELOAD_METHOD]: ReloadPayload;
|
|
304
347
|
[NAVIGATION_OPEN_APP_PAGE_METHOD]: OpenAppPagePayload;
|
|
348
|
+
[CLOUD_LEADERBOARD_SUBMIT_METHOD]: SubmitLeaderboardEntryPayload;
|
|
349
|
+
[CLOUD_LEADERBOARD_GET_LIST_METHOD]: GetLeaderboardListPayload | undefined;
|
|
350
|
+
[CLOUD_LEADERBOARD_GET_CURRENT_USER_ENTRY_METHOD]: GetCurrentUserLeaderboardEntryPayload | undefined;
|
|
351
|
+
[CLOUD_LEADERBOARD_DELETE_CURRENT_USER_ENTRY_METHOD]: DeleteCurrentUserLeaderboardEntryPayload | undefined;
|
|
352
|
+
[CLOUD_LEADERBOARD_GET_INFO_METHOD]: GetLeaderboardInfoPayload | undefined;
|
|
305
353
|
}
|
|
306
354
|
/** bridge method 到标准化响应 payload 的映射。 */
|
|
307
355
|
export interface MiniProgramCapabilityResultMap {
|
|
@@ -327,6 +375,11 @@ export interface MiniProgramCapabilityResultMap {
|
|
|
327
375
|
[NAVIGATION_CLOSE_METHOD]: CloseResult;
|
|
328
376
|
[NAVIGATION_RELOAD_METHOD]: ReloadResult;
|
|
329
377
|
[NAVIGATION_OPEN_APP_PAGE_METHOD]: OpenAppPageResult;
|
|
378
|
+
[CLOUD_LEADERBOARD_SUBMIT_METHOD]: SubmitLeaderboardEntryResult;
|
|
379
|
+
[CLOUD_LEADERBOARD_GET_LIST_METHOD]: GetLeaderboardListResult;
|
|
380
|
+
[CLOUD_LEADERBOARD_GET_CURRENT_USER_ENTRY_METHOD]: GetCurrentUserLeaderboardEntryResult;
|
|
381
|
+
[CLOUD_LEADERBOARD_DELETE_CURRENT_USER_ENTRY_METHOD]: DeleteCurrentUserLeaderboardEntryResult;
|
|
382
|
+
[CLOUD_LEADERBOARD_GET_INFO_METHOD]: GetLeaderboardInfoResult;
|
|
330
383
|
}
|
|
331
384
|
/** 指定 bridge method 的请求 payload。 */
|
|
332
385
|
export type MiniProgramCapabilityPayload<T extends MiniProgramBridgeMethod> = MiniProgramCapabilityPayloadMap[T];
|
package/types/protocol.d.ts
CHANGED
|
@@ -1,9 +1,10 @@
|
|
|
1
1
|
export { MINI_PROGRAM_BRIDGE_NONCE_PARAM, MINI_PROGRAM_MESSAGE_NAMESPACE, MINI_PROGRAM_MESSAGE_VERSION, SDK_HANDSHAKE_METHOD, } from './protocol/constants';
|
|
2
2
|
export { isMiniProgramBridgeMessage } from './protocol/guards';
|
|
3
3
|
export type { MiniProgramBridgeError, MiniProgramBridgeMessage, MiniProgramBridgeMessageType, MiniProgramEventHandler, MiniProgramEventName, MiniProgramEventPayloadMap, } from './protocol/types';
|
|
4
|
-
export { AUTH_LOGIN_METHOD, DEVICE_SET_CLIPBOARD_METHOD, DEVICE_VIBRATE_METHOD, MINI_PROGRAM_PROTOCOL_CAPABILITIES, NAVIGATION_CLOSE_METHOD, NAVIGATION_OPEN_APP_PAGE_METHOD, NAVIGATION_RELOAD_METHOD, NETWORK_REQUEST_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, } from './protocol/capabilities';
|
|
5
|
-
export type { MiniProgramDeviceMethod, MiniProgramAuthMethod, MiniProgramBridgeMethod, MiniProgramCapabilityDefinition, MiniProgramCapabilityModule, MiniProgramCapabilityPayload, MiniProgramCapabilityPayloadMap, MiniProgramCapabilityResult, MiniProgramCapabilityResultMap, MiniProgramCapabilityRisk, MiniProgramNavigationMethod, MiniProgramNetworkMethod, MiniProgramShareMethod, MiniProgramStorageMethod, MiniProgramUiMethod, MiniProgramUserMethod, MiniProgramViewportMethod, } from './protocol/capabilities';
|
|
4
|
+
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, NAVIGATION_CLOSE_METHOD, NAVIGATION_OPEN_APP_PAGE_METHOD, NAVIGATION_RELOAD_METHOD, NETWORK_REQUEST_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, } from './protocol/capabilities';
|
|
5
|
+
export type { MiniProgramDeviceMethod, MiniProgramAuthMethod, MiniProgramBridgeMethod, MiniProgramCapabilityDefinition, MiniProgramCapabilityModule, MiniProgramCapabilityPayload, MiniProgramCapabilityPayloadMap, MiniProgramCapabilityResult, MiniProgramCapabilityResultMap, MiniProgramCapabilityRisk, MiniProgramCloudMethod, MiniProgramNavigationMethod, MiniProgramNetworkMethod, MiniProgramShareMethod, MiniProgramStorageMethod, MiniProgramUiMethod, MiniProgramUserMethod, MiniProgramViewportMethod, } from './protocol/capabilities';
|
|
6
6
|
export type { LoginPayload, LoginResult } from './modules/auth';
|
|
7
|
+
export type { DeleteCurrentUserLeaderboardEntryPayload, DeleteCurrentUserLeaderboardEntryResult, GetCurrentUserLeaderboardEntryPayload, GetCurrentUserLeaderboardEntryResult, GetLeaderboardInfoPayload, GetLeaderboardInfoResult, GetLeaderboardListPayload, GetLeaderboardListResult, LeaderboardEntry, LeaderboardOrder, SubmitLeaderboardEntryPayload, SubmitLeaderboardEntryResult, } from './modules/cloud';
|
|
7
8
|
export type { GetCurrentUserDetailPayload, GetCurrentUserDetailResult, GetCurrentUserProfilePayload, GetCurrentUserProfileResult, GetPlatformAccountInfoPayload, GetPlatformAccountInfoResult, GetPlatformAccountOverviewPayload, GetPlatformAccountOverviewResult, GetSteamGameListOptions, GetSteamGameListPayload, GetSteamGameListResult, GetUserInfoPayload, GetUserInfoResult, MiniProgramUserInfo, MiniProgramUserInfoResult, SteamGameListData, SteamGameListItem, SteamGameListSort, SteamGamePrice, } from './modules/user';
|
|
8
9
|
export type { ScreenshotPayload, ScreenshotResult } from './modules/share/screenshot';
|
|
9
10
|
export type { ShowShareMenuPayload, ShowShareMenuResult } from './modules/share/show-share-menu';
|