@heybox/hb-sdk 0.8.0-alpha.9 → 0.8.1-alpha.1

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.
Files changed (48) hide show
  1. package/CHANGELOG.md +86 -0
  2. package/README.md +25 -19
  3. package/dist/cli-chunks/{build-DkokKVNy.cjs → build-kMLIWqWY.cjs} +8 -5
  4. package/dist/cli-chunks/{context-CKzZxKbF.cjs → context-CzFFRcL4.cjs} +42 -59
  5. package/dist/cli-chunks/{create-BQy5Jdmu.cjs → create-0ow6gA9w.cjs} +1 -1
  6. package/dist/cli-chunks/{dev-Dik2zr5R.cjs → dev-CPBPdpyu.cjs} +26 -15
  7. package/dist/cli-chunks/{doctor-Byr4uwKG.cjs → doctor-DQ8ctFKC.cjs} +1 -1
  8. package/dist/cli-chunks/{index-BwGBr1ZA.cjs → index-Buner4kE.cjs} +15 -15
  9. package/dist/cli-chunks/{index-Cl0XaX8e.cjs → index-RDcIrvwi.cjs} +2 -2
  10. package/dist/cli-chunks/{index.esm-BYifBABc.cjs → index.esm-qwrdRuy-.cjs} +8 -8
  11. package/dist/cli-chunks/{login-Dr9lclu3.cjs → login-DoduAO_f.cjs} +2 -2
  12. package/dist/cli-chunks/{project-vite-BIPrOtRO.cjs → project-vite-B-sK-qup.cjs} +1 -1
  13. package/dist/cli-chunks/{remote-DXxyA14a.cjs → remote-CF_SRmnj.cjs} +57 -25
  14. package/dist/cli-chunks/{runtime-gate-DFjw66kF.cjs → runtime-gate-FseEYZze.cjs} +11 -3
  15. package/dist/cli-chunks/{runtime-permission-env-CjsCe5bp.cjs → runtime-permission-env-DdQtxdut.cjs} +351 -0
  16. package/dist/cli-chunks/{session-B6Mo9eYW.cjs → session-DHbw2Xgh.cjs} +1 -1
  17. package/dist/cli-chunks/{skill-f90sxv28.cjs → skill-6IVv12JW.cjs} +2 -2
  18. package/dist/cli-chunks/{version-DDB_btOG.cjs → version-TXwWxKvv.cjs} +1 -1
  19. package/dist/cli.cjs +1 -1
  20. package/dist/devtools/browser-dev-host/assets/browser-dev-host-TzYf9L6C.js +99 -0
  21. package/dist/devtools/browser-dev-host/assets/{index-DaqmTjSF.js → index-C5MZZDa5.js} +4 -4
  22. package/dist/devtools/browser-dev-host/assets/index-P-ra4m1y.css +1 -0
  23. package/dist/devtools/browser-dev-host/assets/{workbench-state-wHgWRb7I.js → workbench-state-BwV7bm4n.js} +2 -2
  24. package/dist/devtools/browser-dev-host/index.html +3 -3
  25. package/dist/index.cjs.js +99 -1
  26. package/dist/index.esm.js +99 -1
  27. package/dist/protocol.cjs.js +189 -47
  28. package/dist/protocol.esm.js +189 -47
  29. package/dist/templates/vanilla-vite-js/package.json.ejs +2 -1
  30. package/dist/vite.cjs.js +281 -13
  31. package/dist/vite.esm.js +281 -13
  32. package/package.json +9 -11
  33. package/skill/SKILL.md +8 -9
  34. package/skill/references/api-protocol.md +1 -1
  35. package/skill/references/api-root.md +63 -21
  36. package/skill/references/cli.md +6 -6
  37. package/skill/references/examples.md +3 -3
  38. package/skill/references/recipes.md +35 -38
  39. package/skill/references/safety-boundaries.md +9 -5
  40. package/skill/skill.json +5 -5
  41. package/types/core/mini-dev-console.d.ts +36 -0
  42. package/types/miniapp-manifest/index.d.ts +1 -0
  43. package/types/miniapp-manifest/node.d.ts +3 -0
  44. package/types/miniapp-manifest/permissions.d.ts +37 -0
  45. package/types/miniapp-manifest/schema.d.ts +5 -0
  46. package/types/vite/index.d.ts +3 -1
  47. package/dist/devtools/browser-dev-host/assets/browser-dev-host-CbhA4h8z.js +0 -97
  48. package/dist/devtools/browser-dev-host/assets/index-DJFB5ySU.css +0 -1
@@ -1,13 +1,13 @@
1
1
  'use strict';
2
2
 
3
- var index$2 = require('./index-BwGBr1ZA.cjs');
3
+ var index$2 = require('./index-Buner4kE.cjs');
4
4
  var require$$0$3 = require('fs');
5
5
  var require$$0$2 = require('crypto');
6
6
  var require$$1$2 = require('path');
7
7
  var require$$0$5 = require('assert');
8
8
  var require$$0$4 = require('events');
9
9
  var require$$1$1 = require('util');
10
- var runtimePermissionEnv = require('./runtime-permission-env-CjsCe5bp.cjs');
10
+ var runtimePermissionEnv = require('./runtime-permission-env-DdQtxdut.cjs');
11
11
  var require$$0$7 = require('net');
12
12
  var require$$0$6 = require('url');
13
13
  var require$$2$1 = require('http');
@@ -11,8 +11,8 @@ var require$$0$4 = require('url');
11
11
  var require$$0 = require('zlib');
12
12
  var require$$0$1 = require('buffer');
13
13
  var require$$1 = require('util');
14
- var index = require('./index-BwGBr1ZA.cjs');
15
- var dev = require('./dev-Dik2zr5R.cjs');
14
+ var index = require('./index-Buner4kE.cjs');
15
+ var dev = require('./dev-CPBPdpyu.cjs');
16
16
  require('node:module');
17
17
  require('node:fs');
18
18
  require('node:fs/promises');
@@ -27,12 +27,13 @@ require('node:net');
27
27
  require('node:crypto');
28
28
  require('node:dns/promises');
29
29
  require('node:http');
30
- require('./context-CKzZxKbF.cjs');
31
- require('./session-B6Mo9eYW.cjs');
30
+ require('./context-CzFFRcL4.cjs');
31
+ require('./runtime-permission-env-DdQtxdut.cjs');
32
+ require('./version-TXwWxKvv.cjs');
33
+ require('node:async_hooks');
34
+ require('./session-DHbw2Xgh.cjs');
32
35
  require('fs');
33
36
  require('constants');
34
- require('./runtime-permission-env-CjsCe5bp.cjs');
35
- require('node:async_hooks');
36
37
  require('undici');
37
38
  require('./browser-RAy8e8cV.cjs');
38
39
  require('node:process');
@@ -40,8 +41,7 @@ require('node:buffer');
40
41
  require('node:url');
41
42
  require('node:util');
42
43
  require('node:child_process');
43
- require('./project-vite-BIPrOtRO.cjs');
44
- require('./version-DDB_btOG.cjs');
44
+ require('./project-vite-B-sK-qup.cjs');
45
45
 
46
46
  var bufferUtil = {exports: {}};
47
47
 
@@ -3,9 +3,9 @@
3
3
  var promises = require('node:readline/promises');
4
4
  var node_crypto = require('node:crypto');
5
5
  var node_http = require('node:http');
6
- var session = require('./session-B6Mo9eYW.cjs');
6
+ var session = require('./session-DHbw2Xgh.cjs');
7
7
  var browser = require('./browser-RAy8e8cV.cjs');
8
- var index = require('./index-BwGBr1ZA.cjs');
8
+ var index = require('./index-Buner4kE.cjs');
9
9
  require('node:path');
10
10
  require('fs');
11
11
  require('constants');
@@ -5,7 +5,7 @@ var fs$1 = require('node:fs/promises');
5
5
  var node_module = require('node:module');
6
6
  var path = require('node:path');
7
7
  var node_url = require('node:url');
8
- var index = require('./index-BwGBr1ZA.cjs');
8
+ var index = require('./index-Buner4kE.cjs');
9
9
 
10
10
  function findProjectRoot(startDir) {
11
11
  let current = path.resolve(startDir);
@@ -1,16 +1,16 @@
1
1
  'use strict';
2
2
 
3
3
  var promises = require('node:readline/promises');
4
- var index = require('./index-BwGBr1ZA.cjs');
5
- var session = require('./session-B6Mo9eYW.cjs');
4
+ var index = require('./index-Buner4kE.cjs');
5
+ var session = require('./session-DHbw2Xgh.cjs');
6
6
  var childProcess = require('node:child_process');
7
7
  var fs = require('node:fs');
8
8
  var fs$1 = require('node:fs/promises');
9
9
  var path = require('node:path');
10
- var runtimePermissionEnv = require('./runtime-permission-env-CjsCe5bp.cjs');
11
- var runtimeGate = require('./runtime-gate-DFjw66kF.cjs');
10
+ var runtimePermissionEnv = require('./runtime-permission-env-DdQtxdut.cjs');
11
+ var runtimeGate = require('./runtime-gate-FseEYZze.cjs');
12
12
  var node_crypto = require('node:crypto');
13
- var context = require('./context-CKzZxKbF.cjs');
13
+ var context = require('./context-CzFFRcL4.cjs');
14
14
  require('node:module');
15
15
  require('path');
16
16
  require('os');
@@ -23,6 +23,7 @@ require('buffer');
23
23
  require('util');
24
24
  require('fs');
25
25
  require('constants');
26
+ require('./version-TXwWxKvv.cjs');
26
27
  require('node:async_hooks');
27
28
 
28
29
  async function getCDNUploadInfo(options, runtime = {}) {
@@ -271,7 +272,7 @@ function createDefaultCosClient(uploadToken, COS) {
271
272
  };
272
273
  }
273
274
  async function loadCosConstructor() {
274
- const cosModule = await Promise.resolve().then(function () { return require('./index-Cl0XaX8e.cjs'); }).then(function (n) { return n.index; });
275
+ const cosModule = await Promise.resolve().then(function () { return require('./index-RDcIrvwi.cjs'); }).then(function (n) { return n.index; });
275
276
  return cosModule.default;
276
277
  }
277
278
  function formatSize(bytes) {
@@ -530,6 +531,7 @@ async function runDeployCommand(options, runtime = {}) {
530
531
  precheckVersion = precheck.version || precheck.version_normalized || fromVersion;
531
532
  }
532
533
  else {
534
+ const localPermissions = runtimePermissionEnv.readMiniappPermissionsFromPackageJson(projectRoot, runtimePermissionEnv.resolveMiniappSdkVersion());
533
535
  if (typeof packageJson.scripts?.build !== 'string') {
534
536
  throw new Error('package.json scripts.build 未定义,请添加 build 脚本');
535
537
  }
@@ -552,7 +554,8 @@ async function runDeployCommand(options, runtime = {}) {
552
554
  loginBaseUrl,
553
555
  session: session$1,
554
556
  }), { successText: '已读取远端小程序权限' });
555
- skipPlatformCsp = context.shouldSkipMiniappPlatformCsp(detail.runtime_permissions);
557
+ const localNetworkEnabled = !localPermissions.declared || localPermissions.permissions?.network?.enabled === true;
558
+ skipPlatformCsp = localNetworkEnabled && context.shouldSkipMiniappPlatformCsp(detail.runtime_permissions);
556
559
  }
557
560
  catch (error) {
558
561
  logger.warn('未读取到远端 Runtime 权限,构建将继续注入平台 CSP。');
@@ -561,7 +564,8 @@ async function runDeployCommand(options, runtime = {}) {
561
564
  const pm = detectPackageManager(projectRoot);
562
565
  const platform = runtime.platform ?? process.platform;
563
566
  const buildMode = validateBuildMode(env.HB_SDK_ENV?.trim(), platform);
564
- logger.info(`开始构建: ${pm} ${createBuildArgs(pm, buildMode).join(' ')}`);
567
+ const buildScript = await readProjectBuildScript(projectRoot);
568
+ logger.info(`开始构建: ${pm} ${createBuildArgs(pm, buildMode, buildScript).join(' ')}`);
565
569
  await runBuildScript(pm, projectRoot, runtime.spawn ?? childProcess.spawn, {
566
570
  env: runtimePermissionEnv.createMiniappPlatformCspEnv(env, skipPlatformCsp),
567
571
  mode: buildMode,
@@ -801,9 +805,10 @@ function detectPackageManager(projectRoot) {
801
805
  return 'npm';
802
806
  }
803
807
  async function runBuildScript(pm, cwd, spawnImpl, options) {
808
+ const buildScript = await readProjectBuildScript(cwd);
804
809
  await new Promise((resolve, reject) => {
805
810
  const pipeStdoutToStderr = options.outputMode === 'stderr';
806
- const buildArgs = createBuildArgs(pm, options.mode);
811
+ const buildArgs = createBuildArgs(pm, options.mode, buildScript);
807
812
  const isWindows = options.platform === 'win32';
808
813
  const [executable, args] = isWindows ? createWindowsBuildCommand(pm, buildArgs) : [pm, buildArgs];
809
814
  const child = spawnImpl(executable, args, {
@@ -841,8 +846,18 @@ function validateBuildMode(mode, platform) {
841
846
  function escapeWindowsCommandArgument(argument) {
842
847
  return `"${argument}"`;
843
848
  }
844
- function createBuildArgs(pm, mode) {
845
- return ['run', 'build', ...(mode ? [...(pm === 'npm' ? ['--'] : []), '--mode', mode] : [])];
849
+ async function readProjectBuildScript(projectRoot) {
850
+ try {
851
+ const packageJson = JSON.parse(await fs$1.readFile(path.join(projectRoot, 'package.json'), 'utf8'));
852
+ return typeof packageJson.scripts?.build === 'string' ? packageJson.scripts.build : '';
853
+ }
854
+ catch {
855
+ return '';
856
+ }
857
+ }
858
+ function createBuildArgs(pm, mode, buildScript) {
859
+ const modeOption = /\bhb-sdk\s+build\b/.test(buildScript) ? '--env' : '--mode';
860
+ return ['run', 'build', ...(mode ? [...(pm === 'npm' ? ['--'] : []), modeOption, mode] : [])];
846
861
  }
847
862
  async function walkDistFiles(distDir) {
848
863
  const results = [];
@@ -1171,7 +1186,10 @@ async function remoteEntitySwitch(options, context, runtime) {
1171
1186
  async function remoteList(options, context, runtime) {
1172
1187
  const result = await context.api.listMiniPrograms({ keyword: options.keyword, status: options.status });
1173
1188
  const items = Array.isArray(result.items) ? result.items : [];
1174
- const outputItems = items.map((item) => ({ ...toCamelCaseDeep(item), bound: item.mini_program_id === context.binding }));
1189
+ const outputItems = items.map((item) => ({
1190
+ ...toCamelCaseDeep(item),
1191
+ bound: item.mini_program_id === context.binding,
1192
+ }));
1175
1193
  const output = { changed: false, items: outputItems, total: readNumber(result.total, items.length) };
1176
1194
  if (!options.json) {
1177
1195
  if (items.length === 0) {
@@ -1228,9 +1246,11 @@ async function remoteBind(options, context$1, runtime) {
1228
1246
  async function remoteInfo(options, context, runtime) {
1229
1247
  const miniProgramId = requireBinding(context);
1230
1248
  const detail = await context.api.getMiniProgramDetail(miniProgramId);
1231
- const output = { changed: false, miniProgramId, detail: toCamelCaseDeep(detail) };
1249
+ const localPermissions = runtimePermissionEnv.readMiniappPermissionsFromPackageJson(context.packageJson.projectRoot, runtimePermissionEnv.resolveMiniappSdkVersion());
1250
+ const permissionViews = runtimePermissionEnv.composeMiniappRuntimePermissions(localPermissions, detail.runtime_permissions).views;
1251
+ const output = { changed: false, miniProgramId, detail: toCamelCaseDeep(detail), permissions: permissionViews };
1232
1252
  if (!options.json) {
1233
- printMiniProgramDetail(context.logger, detail);
1253
+ printMiniProgramDetail(context.logger, detail, permissionViews);
1234
1254
  }
1235
1255
  return finishRemoteCommand(options, runtime, output);
1236
1256
  }
@@ -1356,7 +1376,9 @@ async function remotePreview(options, context, runtime) {
1356
1376
  }
1357
1377
  async function remoteDangerousWrite(options, context, runtime) {
1358
1378
  const miniProgramId = requireBinding(context);
1359
- const version = options.command === 'release' || options.command === 'withdraw' ? requireNonEmpty(options.version, `remote ${options.command} 必须传 <version>`) : undefined;
1379
+ const version = options.command === 'release' || options.command === 'withdraw'
1380
+ ? requireNonEmpty(options.version, `remote ${options.command} 必须传 <version>`)
1381
+ : undefined;
1360
1382
  const detail = await context.api.getMiniProgramDetail(miniProgramId);
1361
1383
  await confirmDangerousRemoteChange(options, runtime, context.logger, {
1362
1384
  miniProgramId,
@@ -1545,7 +1567,18 @@ function parseEntityId(value) {
1545
1567
  return entityId;
1546
1568
  }
1547
1569
  async function listDeveloperEntitiesWithAccessFallback(context) {
1548
- const result = await context.api.listDeveloperEntities();
1570
+ let result;
1571
+ try {
1572
+ result = await context.api.listDeveloperEntities();
1573
+ }
1574
+ catch (error) {
1575
+ const fallback = createEntityFromAccessStatus(await context.api.accessStatus());
1576
+ if (!fallback) {
1577
+ throw error;
1578
+ }
1579
+ context.logger.debug('开发者主体列表不可用,已回退使用小程序工坊准入主体');
1580
+ return { fromAccessFallback: true, items: [fallback], total: 1 };
1581
+ }
1549
1582
  const items = normalizeDeveloperEntities(result);
1550
1583
  if (items.length > 0) {
1551
1584
  return { items, total: readNumber(result.total, items.length) };
@@ -1716,7 +1749,7 @@ async function promptConfirm(message, runtime) {
1716
1749
  rl.close();
1717
1750
  }
1718
1751
  }
1719
- function printMiniProgramDetail(logger, detail) {
1752
+ function printMiniProgramDetail(logger, detail, permissionViews) {
1720
1753
  logger.info(`Mini-program: ${detail.mini_program_id ?? '--'}`);
1721
1754
  logger.info(`Name: ${detail.name ?? '--'}`);
1722
1755
  logger.info(`Status: ${detail.status ?? '--'}`);
@@ -1727,14 +1760,13 @@ function printMiniProgramDetail(logger, detail) {
1727
1760
  if (detail.protocol_string) {
1728
1761
  logger.info(`Protocol: ${detail.protocol_string}`);
1729
1762
  }
1730
- const runtimePermissions = detail.runtime_permissions;
1731
- if (runtimePermissions) {
1732
- logger.info(`Runtime 权限: schema=${String(runtimePermissions.schema_version ?? '--')} revision=${String(runtimePermissions.revision ?? '--')}`);
1733
- if (Array.isArray(runtimePermissions.entries)) {
1734
- runtimePermissions.entries.forEach((entry) => {
1735
- logger.info(` ${JSON.stringify(entry)}`);
1736
- });
1737
- }
1763
+ logger.info('权限:');
1764
+ for (const view of permissionViews) {
1765
+ const approval = view.access === 'platform-approval' ? ` 需申请=是 批准=${view.approved ? '' : '否'}` : ' 需申请=否';
1766
+ const configs = view.requestedConfig
1767
+ ? ` requested=${JSON.stringify(view.requestedConfig)} approved=${JSON.stringify(view.approvedConfig)} effective=${JSON.stringify(view.effectiveConfig)}`
1768
+ : '';
1769
+ logger.info(` ${view.key}: 声明=${view.declared ? '是' : '否'}${approval} 最终=${view.effective ? '可用' : '不可用'}${configs}`);
1738
1770
  }
1739
1771
  }
1740
1772
  function printDeveloperEntities(logger, entities) {
@@ -1,6 +1,6 @@
1
1
  'use strict';
2
2
 
3
- var runtimePermissionEnv = require('./runtime-permission-env-CjsCe5bp.cjs');
3
+ var runtimePermissionEnv = require('./runtime-permission-env-DdQtxdut.cjs');
4
4
 
5
5
  const MINIAPP_PLATFORM_VALUES = ['android', 'ios', 'ohos', 'windows', 'macos', 'linux'];
6
6
  function isValidMiniappManifestVersion(version) {
@@ -32,10 +32,18 @@ function parseMiniappManifestJson(raw, sourceLabel = 'manifest.json') {
32
32
  };
33
33
  }
34
34
  function validateMiniappManifestForDeploy(manifest) {
35
+ const version = validateMiniappManifestVersion(manifest.version, 'manifest.version');
36
+ const sdkVersion = validateSdkVersion(manifest.sdkVersion, 'manifest.sdkVersion');
37
+ const permissions = runtimePermissionEnv.parseMiniappPermissions(manifest.permissions, {
38
+ present: Object.prototype.hasOwnProperty.call(manifest, 'permissions'),
39
+ sdkVersion,
40
+ sourceLabel: 'manifest.permissions',
41
+ });
35
42
  return {
36
- version: validateMiniappManifestVersion(manifest.version, 'manifest.version'),
37
- sdkVersion: validateSdkVersion(manifest.sdkVersion, 'manifest.sdkVersion'),
43
+ version,
44
+ sdkVersion,
38
45
  platforms: validateMiniappPlatforms(manifest.platforms, 'manifest.platforms'),
46
+ ...(permissions.permissions === undefined ? {} : { permissions: permissions.permissions }),
39
47
  };
40
48
  }
41
49
  function validateMiniappPlatforms(platforms, sourceLabel = 'platforms') {