@heybox/hb-sdk 0.7.4-alpha.4 → 0.7.4-alpha.5

package/CHANGELOG.md

@@ -1,5 +1,11 @@
 # Changelog
 
+## 0.7.4-alpha.5
+
+### Share extra
+
+- `share.showShareMenu()` 支持携带 JSON-compatible `extra`，新增 `share.copyLink()` 复制并返回相同格式的通用分享链接；链接启动后可通过同步 `share.getExtra()` 恢复页面状态。
+
 ## 0.7.4-alpha.4
 
 ### SDK

package/README.md

@@ -110,7 +110,7 @@ SDK 还提供 `getHandshakeState()` / `onHandshakeStateChange()` 管理持久握
 | ------------ | ------------------------------------------------------------ |
 | `auth`       | 获取交给开发者服务端交换的短期授权码                         |
 | `user`       | 读取 Host 当前用户资料、隔离身份或撤销授权                   |
-| `share`      | 打开分享或截图分享流程                                       |
+| `share`      | 打开分享、复制链接或截图分享流程                             |
 | `ui`         | 展示 Toast 和 Loading                                        |
 | `device`     | 调用振动和剪贴板能力                                         |
 | `navigation` | 关闭、刷新页面或打开小黑盒页面                               |
@@ -139,6 +139,22 @@ SDK 还提供 `getHandshakeState()` / `onHandshakeStateChange()` 管理持久握
 - 仅当远端已启用 `network.request` 时，`hb-sdk dev` 与 `hb-sdk remote deploy` 构建才会跳过平台 CSP；其他构建继续注入平台 CSP。`useOfficialDomain` 不参与 CSP 跳过判定。
 - 构建必须启用 `miniappManifest()`，推荐统一使用 `hb-sdk build`。
 
+## 分享扩展数据
+
+默认分享和复制链接可以携带小程序自行定义的页面状态：
+
+```ts
+await hbSDK.share.showShareMenu({
+  title: '排行榜',
+  desc: '查看当前排名',
+  extra: { page: 'ranking', options: [1, 2, 3] },
+});
+
+const sharedState = hbSDK.share.getExtra();
+```
+
+`extra` 只支持 JSON-compatible 数据，没有有效数据时 `getExtra()` 返回 `undefined`。完整的路由示例和参数限制见[社区分享预置](https://docs.xiaoheihe.cn/hb_sdk/recipes/community-share)。
+
 ## 云端排行榜
 
 删除当前用户的排行榜成绩属于破坏性操作，只能在明确的用户操作和二次确认后执行：

package/dist/cli-chunks/{build-BqGFRLe-.cjs → build-C-ufarA6.cjs}

@@ -5,8 +5,8 @@ var fs = require('node:fs/promises');
 var path = require('node:path');
 var runtimePermissionEnv = require('./runtime-permission-env-D-8_jPG3.cjs');
 var runtimeGate = require('./runtime-gate-CtV7rWyX.cjs');
-var index = require('./index-CyEqCbeu.cjs');
-var projectVite = require('./project-vite-BUY9DgYo.cjs');
+var index = require('./index-CT94XzyO.cjs');
+var projectVite = require('./project-vite-zaw68V1G.cjs');
 require('node:async_hooks');
 require('node:module');
 require('path');

package/dist/cli-chunks/{context-DTr3hRTv.cjs → context-C839--TH.cjs}

@@ -1,6 +1,6 @@
 'use strict';
 
-var session = require('./session-BUjFX2U2.cjs');
+var session = require('./session-D692TU5N.cjs');
 var runtimePermissionEnv = require('./runtime-permission-env-D-8_jPG3.cjs');
 var fs$1 = require('node:fs');
 var fs = require('node:fs/promises');

package/dist/cli-chunks/{create-OkiiiH4I.cjs → create-CNcII_CB.cjs}

@@ -5,7 +5,7 @@ var fs = require('node:fs/promises');
 var path = require('node:path');
 var require$$0 = require('fs');
 var require$$1 = require('path');
-var index = require('./index-CyEqCbeu.cjs');
+var index = require('./index-CT94XzyO.cjs');
 require('node:module');
 require('os');
 require('readline');

package/dist/cli-chunks/{dev-j7W9R7ew.cjs → dev-MpESCaMm.cjs}

@@ -6,15 +6,15 @@ var path = require('node:path');
 var net = require('node:net');
 var promises = require('node:dns/promises');
 var node_http = require('node:http');
-var context = require('./context-DTr3hRTv.cjs');
+var context = require('./context-C839--TH.cjs');
 var node_crypto = require('node:crypto');
 var undici = require('undici');
 var browser = require('./browser-RAy8e8cV.cjs');
-var index = require('./index-CyEqCbeu.cjs');
-var projectVite = require('./project-vite-BUY9DgYo.cjs');
+var index = require('./index-CT94XzyO.cjs');
+var projectVite = require('./project-vite-zaw68V1G.cjs');
 var fs$1 = require('node:fs/promises');
 var runtimePermissionEnv = require('./runtime-permission-env-D-8_jPG3.cjs');
-require('./session-BUjFX2U2.cjs');
+require('./session-D692TU5N.cjs');
 require('fs');
 require('constants');
 require('stream');
@@ -2005,7 +2005,7 @@ function createHeyboxProtocol(payload) {
 /** 构建时替换为当前发布包的实际版本。 */
 const HB_SDK_VERSION = typeof undefined === 'string'
     ? undefined
-    : '0.7.4-alpha.4';
+    : '0.7.4-alpha.5';
 
 class DevPermissionOverrideStoreError extends Error {
     code;

package/dist/cli-chunks/{doctor-BO0vkDny.cjs → doctor-bhfQwyYU.cjs}

@@ -4,7 +4,7 @@ var fs$1 = require('node:fs');
 var fs = require('node:fs/promises');
 var os = require('node:os');
 var path = require('node:path');
-var index = require('./index-CyEqCbeu.cjs');
+var index = require('./index-CT94XzyO.cjs');
 require('node:module');
 require('path');
 require('os');

package/dist/cli-chunks/{index-CZuvk1Rg.cjs → index-B_qJzSFo.cjs}

@@ -1,6 +1,6 @@
 'use strict';
 
-var index$2 = require('./index-CyEqCbeu.cjs');
+var index$2 = require('./index-CT94XzyO.cjs');
 var require$$0$2 = require('fs');
 var require$$2$1 = require('crypto');
 var require$$1$2 = require('path');

package/dist/cli-chunks/{index-CyEqCbeu.cjs → index-CT94XzyO.cjs}

@@ -234,19 +234,19 @@ function requireArgument () {
 
 var command = {};
 
-const require$5 = node_module.createRequire((typeof document === 'undefined' ? require('u' + 'rl').pathToFileURL(__filename).href : (_documentCurrentScript && _documentCurrentScript.tagName.toUpperCase() === 'SCRIPT' && _documentCurrentScript.src || new URL('cli-chunks/index-CyEqCbeu.cjs', document.baseURI).href)));
+const require$5 = node_module.createRequire((typeof document === 'undefined' ? require('u' + 'rl').pathToFileURL(__filename).href : (_documentCurrentScript && _documentCurrentScript.tagName.toUpperCase() === 'SCRIPT' && _documentCurrentScript.src || new URL('cli-chunks/index-CT94XzyO.cjs', document.baseURI).href)));
 function __require$4() { return require$5("node:events"); }
 
-const require$4 = node_module.createRequire((typeof document === 'undefined' ? require('u' + 'rl').pathToFileURL(__filename).href : (_documentCurrentScript && _documentCurrentScript.tagName.toUpperCase() === 'SCRIPT' && _documentCurrentScript.src || new URL('cli-chunks/index-CyEqCbeu.cjs', document.baseURI).href)));
+const require$4 = node_module.createRequire((typeof document === 'undefined' ? require('u' + 'rl').pathToFileURL(__filename).href : (_documentCurrentScript && _documentCurrentScript.tagName.toUpperCase() === 'SCRIPT' && _documentCurrentScript.src || new URL('cli-chunks/index-CT94XzyO.cjs', document.baseURI).href)));
 function __require$3() { return require$4("node:child_process"); }
 
-const require$3 = node_module.createRequire((typeof document === 'undefined' ? require('u' + 'rl').pathToFileURL(__filename).href : (_documentCurrentScript && _documentCurrentScript.tagName.toUpperCase() === 'SCRIPT' && _documentCurrentScript.src || new URL('cli-chunks/index-CyEqCbeu.cjs', document.baseURI).href)));
+const require$3 = node_module.createRequire((typeof document === 'undefined' ? require('u' + 'rl').pathToFileURL(__filename).href : (_documentCurrentScript && _documentCurrentScript.tagName.toUpperCase() === 'SCRIPT' && _documentCurrentScript.src || new URL('cli-chunks/index-CT94XzyO.cjs', document.baseURI).href)));
 function __require$2() { return require$3("node:path"); }
 
-const require$2 = node_module.createRequire((typeof document === 'undefined' ? require('u' + 'rl').pathToFileURL(__filename).href : (_documentCurrentScript && _documentCurrentScript.tagName.toUpperCase() === 'SCRIPT' && _documentCurrentScript.src || new URL('cli-chunks/index-CyEqCbeu.cjs', document.baseURI).href)));
+const require$2 = node_module.createRequire((typeof document === 'undefined' ? require('u' + 'rl').pathToFileURL(__filename).href : (_documentCurrentScript && _documentCurrentScript.tagName.toUpperCase() === 'SCRIPT' && _documentCurrentScript.src || new URL('cli-chunks/index-CT94XzyO.cjs', document.baseURI).href)));
 function __require$1() { return require$2("node:fs"); }
 
-const require$1 = node_module.createRequire((typeof document === 'undefined' ? require('u' + 'rl').pathToFileURL(__filename).href : (_documentCurrentScript && _documentCurrentScript.tagName.toUpperCase() === 'SCRIPT' && _documentCurrentScript.src || new URL('cli-chunks/index-CyEqCbeu.cjs', document.baseURI).href)));
+const require$1 = node_module.createRequire((typeof document === 'undefined' ? require('u' + 'rl').pathToFileURL(__filename).href : (_documentCurrentScript && _documentCurrentScript.tagName.toUpperCase() === 'SCRIPT' && _documentCurrentScript.src || new URL('cli-chunks/index-CT94XzyO.cjs', document.baseURI).href)));
 function __require() { return require$1("node:process"); }
 
 var help = {};
@@ -13347,7 +13347,7 @@ function getPathname(pathWithQuery) {
 }
 
 const CLI_VERSION_PLACEHOLDER = ['__HB', 'SDK', 'CLI', 'VERSION__'].join('_');
-const BUILT_CLI_VERSION = '0.7.4-alpha.4';
+const BUILT_CLI_VERSION = '0.7.4-alpha.5';
 const PACKAGE_JSON_CANDIDATES = [
     path.resolve(__dirname, '..', '..', 'package.json'),
     path.resolve(__dirname, '..', 'package.json'),
@@ -13684,35 +13684,35 @@ function createCommandLoggerResolver(options) {
     };
 }
 const defaultClearLoginStatus = async (...args) => {
-    const { clearLoginStatus } = await Promise.resolve().then(function () { return require('./login-CuAGltGs.cjs'); });
+    const { clearLoginStatus } = await Promise.resolve().then(function () { return require('./login-hYrDJ3dR.cjs'); });
     return clearLoginStatus(...args);
 };
 const defaultLoginToHeybox = async (...args) => {
-    const { loginToHeybox } = await Promise.resolve().then(function () { return require('./login-CuAGltGs.cjs'); });
+    const { loginToHeybox } = await Promise.resolve().then(function () { return require('./login-hYrDJ3dR.cjs'); });
     return loginToHeybox(...args);
 };
 const defaultPrintLoginStatus = async (...args) => {
-    const { printLoginStatus } = await Promise.resolve().then(function () { return require('./login-CuAGltGs.cjs'); });
+    const { printLoginStatus } = await Promise.resolve().then(function () { return require('./login-hYrDJ3dR.cjs'); });
     return printLoginStatus(...args);
 };
 const defaultRunBuildCommand = async (...args) => {
-    const { runBuildCommand } = await Promise.resolve().then(function () { return require('./build-BqGFRLe-.cjs'); });
+    const { runBuildCommand } = await Promise.resolve().then(function () { return require('./build-C-ufarA6.cjs'); });
     return runBuildCommand(...args);
 };
 const defaultRunCreateCommand = async (...args) => {
-    const { runCreateCommand } = await Promise.resolve().then(function () { return require('./create-OkiiiH4I.cjs'); });
+    const { runCreateCommand } = await Promise.resolve().then(function () { return require('./create-CNcII_CB.cjs'); });
     return runCreateCommand(...args);
 };
 const defaultRunDevCommand = async (...args) => {
-    const { runDevCommand } = await Promise.resolve().then(function () { return require('./dev-j7W9R7ew.cjs'); });
+    const { runDevCommand } = await Promise.resolve().then(function () { return require('./dev-MpESCaMm.cjs'); });
     return runDevCommand(...args);
 };
 const defaultRunDoctorCommand = async (...args) => {
-    const { runDoctorCommand } = await Promise.resolve().then(function () { return require('./doctor-BO0vkDny.cjs'); });
+    const { runDoctorCommand } = await Promise.resolve().then(function () { return require('./doctor-bhfQwyYU.cjs'); });
     return runDoctorCommand(...args);
 };
 const defaultRunRemoteCommand = async (...args) => {
-    const { runRemoteCommand } = await Promise.resolve().then(function () { return require('./remote-tPMcxgpi.cjs'); });
+    const { runRemoteCommand } = await Promise.resolve().then(function () { return require('./remote-DQZRAAHh.cjs'); });
     return runRemoteCommand(...args);
 };
 function resolveStandaloneLogger(options, verbose) {

package/dist/cli-chunks/{login-CuAGltGs.cjs → login-hYrDJ3dR.cjs}

@@ -3,9 +3,9 @@
 var promises = require('node:readline/promises');
 var node_crypto = require('node:crypto');
 var node_http = require('node:http');
-var session = require('./session-BUjFX2U2.cjs');
+var session = require('./session-D692TU5N.cjs');
 var browser = require('./browser-RAy8e8cV.cjs');
-var index = require('./index-CyEqCbeu.cjs');
+var index = require('./index-CT94XzyO.cjs');
 require('node:path');
 require('fs');
 require('constants');

package/dist/cli-chunks/{project-vite-BUY9DgYo.cjs → project-vite-zaw68V1G.cjs}

@@ -5,7 +5,7 @@ var fs$1 = require('node:fs/promises');
 var node_module = require('node:module');
 var path = require('node:path');
 var node_url = require('node:url');
-var index = require('./index-CyEqCbeu.cjs');
+var index = require('./index-CT94XzyO.cjs');
 
 function findProjectRoot(startDir) {
     let current = path.resolve(startDir);

package/dist/cli-chunks/{remote-tPMcxgpi.cjs → remote-DQZRAAHh.cjs}

@@ -1,8 +1,8 @@
 'use strict';
 
 var promises = require('node:readline/promises');
-var index = require('./index-CyEqCbeu.cjs');
-var session = require('./session-BUjFX2U2.cjs');
+var index = require('./index-CT94XzyO.cjs');
+var session = require('./session-D692TU5N.cjs');
 var childProcess = require('node:child_process');
 var fs = require('node:fs');
 var fs$1 = require('node:fs/promises');
@@ -10,7 +10,7 @@ var path = require('node:path');
 var runtimePermissionEnv = require('./runtime-permission-env-D-8_jPG3.cjs');
 var runtimeGate = require('./runtime-gate-CtV7rWyX.cjs');
 var node_crypto = require('node:crypto');
-var context = require('./context-DTr3hRTv.cjs');
+var context = require('./context-C839--TH.cjs');
 require('node:module');
 require('path');
 require('os');
@@ -271,7 +271,7 @@ function createDefaultCosClient(uploadToken, COS) {
     };
 }
 async function loadCosConstructor() {
-    const cosModule = await Promise.resolve().then(function () { return require('./index-CZuvk1Rg.cjs'); }).then(function (n) { return n.index; });
+    const cosModule = await Promise.resolve().then(function () { return require('./index-B_qJzSFo.cjs'); }).then(function (n) { return n.index; });
     return cosModule.default;
 }
 function formatSize(bytes) {

package/dist/cli-chunks/{session-BUjFX2U2.cjs → session-D692TU5N.cjs}

@@ -1,6 +1,6 @@
 'use strict';
 
-var index = require('./index-CyEqCbeu.cjs');
+var index = require('./index-CT94XzyO.cjs');
 var node_crypto = require('node:crypto');
 var path = require('node:path');
 var require$$0$2 = require('fs');

package/dist/cli.cjs

@@ -1,6 +1,6 @@
 'use strict';
 
-var index = require('./cli-chunks/index-CyEqCbeu.cjs');
+var index = require('./cli-chunks/index-CT94XzyO.cjs');
 require('node:module');
 require('node:fs');
 require('node:fs/promises');