@heybox/hb-sdk 0.9.2-alpha.7 → 0.9.2-alpha.8

package/dist/cli-chunks/{remote-dvOjaxJu.cjs → remote-CZuy1lmn.cjs}

@@ -1,17 +1,18 @@
 'use strict';
 
-var runtimePermissionEnv = require('./runtime-permission-env-B9SqoP85.cjs');
-var context = require('./context-DQhjWa7X.cjs');
+var runtimePermissionEnv = require('./runtime-permission-env-CDx5qO-T.cjs');
+var context = require('./context-BI3QMxw2.cjs');
 var promises = require('node:readline/promises');
-var index = require('./index-bZIxID9N.cjs');
-var runtimeGate = require('./runtime-gate-BKc2zPV-.cjs');
+var index = require('./index-CY67PpQk.cjs');
+var runtimeGate = require('./runtime-gate-g3afiufR.cjs');
 var childProcess = require('node:child_process');
 var fs = require('node:fs');
 var fs$1 = require('node:fs/promises');
 var path = require('node:path');
 var node_crypto = require('node:crypto');
 require('node:zlib');
-require('./version-CwEOrhL1.cjs');
+var deployLock = require('./deploy-lock-pKDDxTKm.cjs');
+require('./version-D40WHkF9.cjs');
 require('node:async_hooks');
 require('sharp');
 require('node:module');
@@ -33,6 +34,27 @@ require('inspector');
 // 脚手架开发占位图；构建可用，提审前必须替换。
 const BASIC_INFO_PLACEHOLDER_SHA256 = 'd14e54b30f5e6d1bcbf51267bc82b06a0af7c333f2945bcc16b4e1adc3b123dd';
 
+/** 根据当前项目声明或实际版本 Manifest 检查资料完整性，不联网、不修改输入。 */
+function getMiniappMetadataWarnings(metadata) {
+    const warnings = [];
+    if (metadata.desc === undefined || (typeof metadata.desc === 'string' && !metadata.desc.trim())) {
+        warnings.push({
+            code: 'MINIAPP_DESC_MISSING',
+            field: 'desc',
+            message: '尚未填写小程序简介。建议在 package.json#heybox.desc 中说明主要功能和适用场景，修改后重新构建。',
+        });
+    }
+    if (metadata.category === 'tool' &&
+        (metadata.bindAppIds === undefined || (Array.isArray(metadata.bindAppIds) && metadata.bindAppIds.length === 0))) {
+        warnings.push({
+            code: 'MINIAPP_TOOL_GAME_BINDING_MISSING',
+            field: 'bindAppIds',
+            message: '当前小程序为工具类，尚未关联游戏。如服务于特定 PC 游戏，可通过 hb-sdk remote games search "游戏名" 查询 appid 并填写 package.json#heybox.bindAppIds，修改后重新构建；通用工具可保持为空。',
+        });
+    }
+    return warnings;
+}
+
 const CREATE_USER_MINIPROGRAM_UPLOAD_SESSION_API_PATH = '/mall/developer/user_miniprogram/version/upload_session/create';
 const RECORD_USER_MINIPROGRAM_UPLOAD_RESULT_API_PATH = '/mall/developer/user_miniprogram/version/upload_session/record';
 const COMPANION_FINALIZATION_TIMEOUT_MS = 30 * 60_000;
@@ -286,7 +308,7 @@ function createDefaultCosClient(uploadToken, COS) {
     };
 }
 async function loadCosConstructor() {
-    const cosModule = await Promise.resolve().then(function () { return require('./index-DZUYwb3h.cjs'); }).then(function (n) { return n.index; });
+    const cosModule = await Promise.resolve().then(function () { return require('./index-C7nrP0tt.cjs'); }).then(function (n) { return n.index; });
     return cosModule.default;
 }
 function formatSize(bytes) {
@@ -353,144 +375,6 @@ async function computeMiniappArtifactReceipt(files, runtime = {}) {
     return { artifactSignature: hash.digest('hex'), files: preparedFiles };
 }
 
-const DEPLOY_LOCKED_MESSAGE = '当前设备已有同版本产物正在上传，请等待完成后重试';
-const DEPLOY_LOCK_DIRECTORY_NAME = 'deploy-locks';
-const DEPLOY_LOCK_OWNER_FILE = 'owner.json';
-const INCOMPLETE_LOCK_GRACE_MS = 30_000;
-const defaultPaths = index.envPaths('hb-sdk', { suffix: '' });
-class DeployLockConflictError extends Error {
-}
-async function withDeployLock(scope, operation, options = {}) {
-    let lock;
-    try {
-        lock = await acquireDeployLock(scope, options);
-    }
-    catch (error) {
-        if (error instanceof DeployLockConflictError) {
-            throw error;
-        }
-        // 本地文件锁只减少重复操作，文件系统异常不阻断服务端上传流程。
-        return operation();
-    }
-    try {
-        return await operation();
-    }
-    finally {
-        await lock.release().catch(() => undefined);
-    }
-}
-async function acquireDeployLock(scope, options = {}) {
-    const lockDirectory = getDeployLockDirectory(scope, options.cacheRoot);
-    const ownerFile = path.join(lockDirectory, DEPLOY_LOCK_OWNER_FILE);
-    const owner = {
-        version: 1,
-        pid: options.pid ?? process.pid,
-        token: options.token ?? node_crypto.randomBytes(16).toString('hex'),
-    };
-    await fs$1.mkdir(path.dirname(lockDirectory), { recursive: true, mode: 0o700 });
-    for (let attempt = 0; attempt < 2; attempt += 1) {
-        let created = false;
-        try {
-            await fs$1.mkdir(lockDirectory, { mode: 0o700 });
-            created = true;
-            await fs$1.writeFile(ownerFile, `${JSON.stringify(owner)}\n`, { encoding: 'utf8', mode: 0o600 });
-            return createDeployLock(lockDirectory, ownerFile, owner.token);
-        }
-        catch (error) {
-            if (created) {
-                await fs$1.rm(lockDirectory, { force: true, recursive: true });
-                throw error;
-            }
-            if (!isNodeError(error) || error.code !== 'EEXIST') {
-                throw error;
-            }
-            if (!(await canReclaimDeployLock(lockDirectory, ownerFile, options))) {
-                throw new DeployLockConflictError(DEPLOY_LOCKED_MESSAGE);
-            }
-            await reclaimDeployLock(lockDirectory, owner.token);
-        }
-    }
-    throw new DeployLockConflictError(DEPLOY_LOCKED_MESSAGE);
-}
-function getDeployLockDirectory(scope, cacheRoot = defaultPaths.cache) {
-    const scopeHash = node_crypto.createHash('sha256').update(`${scope.apiBaseUrl}\0${scope.miniProgramId}\0${scope.version}`).digest('hex');
-    return path.join(cacheRoot, DEPLOY_LOCK_DIRECTORY_NAME, scopeHash);
-}
-function createDeployLock(lockDirectory, ownerFile, token) {
-    let released = false;
-    return {
-        async release() {
-            if (released)
-                return;
-            released = true;
-            await removeOwnedLock(lockDirectory, ownerFile, token);
-        },
-    };
-}
-async function canReclaimDeployLock(lockDirectory, ownerFile, options) {
-    const owner = await readDeployLockOwner(ownerFile);
-    if (owner) {
-        return !(options.isProcessRunning ?? isProcessRunning)(owner.pid);
-    }
-    try {
-        const lockStat = await fs$1.stat(lockDirectory);
-        return (options.now ?? Date.now)() - lockStat.mtimeMs >= INCOMPLETE_LOCK_GRACE_MS;
-    }
-    catch (error) {
-        return isNodeError(error) && error.code === 'ENOENT';
-    }
-}
-async function removeOwnedLock(lockDirectory, ownerFile, token) {
-    const owner = await readDeployLockOwner(ownerFile);
-    if (owner?.token === token) {
-        await fs$1.rm(lockDirectory, { force: true, recursive: true });
-    }
-}
-async function reclaimDeployLock(lockDirectory, token) {
-    const reclaimDirectory = `${lockDirectory}.reclaim-${node_crypto.createHash('sha256').update(token).digest('hex')}`;
-    try {
-        await fs$1.rename(lockDirectory, reclaimDirectory);
-    }
-    catch (error) {
-        if (isNodeError(error) && error.code === 'ENOENT')
-            return;
-        throw error;
-    }
-    await fs$1.rm(reclaimDirectory, { force: true, recursive: true });
-}
-async function readDeployLockOwner(ownerFile) {
-    try {
-        const value = JSON.parse(await fs$1.readFile(ownerFile, 'utf8'));
-        return isDeployLockOwner(value) ? value : null;
-    }
-    catch (error) {
-        if (isNodeError(error) && error.code === 'ENOENT')
-            return null;
-        if (error instanceof SyntaxError)
-            return null;
-        throw error;
-    }
-}
-function isDeployLockOwner(value) {
-    return (typeof value === 'object' &&
-        value !== null &&
-        value.version === 1 &&
-        Number.isInteger(value.pid) &&
-        typeof value.token === 'string');
-}
-function isProcessRunning(pid) {
-    try {
-        process.kill(pid, 0);
-        return true;
-    }
-    catch (error) {
-        return !isNodeError(error) || error.code !== 'ESRCH';
-    }
-}
-function isNodeError(error) {
-    return error instanceof Error && 'code' in error;
-}
-
 /** 发布提示使用显式声明与远端主体批准策略，不消费本地调试授权。 */
 function getUnapprovedPermissionWarning(local, approvals, partyType) {
     if (!local.declared)
@@ -610,7 +494,7 @@ async function runDeployCommand(options, runtime = {}) {
             const buildScript = await readProjectBuildScript(projectRoot);
             logger.info(`开始构建: ${pm} ${createBuildArgs(pm, buildMode, buildScript).join(' ')}`);
             await runBuildScript(pm, projectRoot, runtime.spawn ?? childProcess.spawn, {
-                env: runtimePermissionEnv.createMiniappPlatformCspEnv(env, skipPlatformCsp),
+                env: { ...runtimePermissionEnv.createMiniappPlatformCspEnv(env, skipPlatformCsp), HB_SDK_DEFER_METADATA_WARNINGS: '1' },
                 mode: buildMode,
                 outputMode: options.buildOutputMode ?? 'inherit',
                 platform,
@@ -627,6 +511,9 @@ async function runDeployCommand(options, runtime = {}) {
             const distDir = path.join(projectRoot, 'dist');
             const parsedManifest = await readDeployManifest(projectRoot, logger);
             ({ manifest, version } = parsedManifest);
+            for (const warning of getMiniappMetadataWarnings(manifest)) {
+                logger.warn(`[${warning.code}] ${warning.message}`, { stream: 'stderr' });
+            }
             if (manifest.category !== declaredCategory) {
                 throw new Error('dist/manifest.json.category 与 package.json#heybox.category 不一致，请重新 build 后再 deploy');
             }
@@ -792,7 +679,7 @@ async function runDeployCommand(options, runtime = {}) {
             version,
         };
     };
-    return (runtime.withDeployLock ?? withDeployLock)({ apiBaseUrl, miniProgramId, version: uploadVersion }, deploy);
+    return (runtime.withDeployLock ?? deployLock.withDeployLock)({ apiBaseUrl, miniProgramId, version: uploadVersion }, deploy);
 }
 function printDeploySuccess(options) {
     options.logger.success(`提交审核成功：${options.miniProgramId} ${options.version}`);

package/dist/cli-chunks/{runtime-gate-BKc2zPV-.cjs → runtime-gate-g3afiufR.cjs}

@@ -5,8 +5,8 @@ require('node:module');
 require('node:url');
 var fs = require('node:fs');
 var path = require('node:path');
-var runtimePermissionEnv = require('./runtime-permission-env-B9SqoP85.cjs');
-var index = require('./index-bZIxID9N.cjs');
+var runtimePermissionEnv = require('./runtime-permission-env-CDx5qO-T.cjs');
+var index = require('./index-CY67PpQk.cjs');
 var _commonjsDynamicModules = require('./_commonjs-dynamic-modules-DUamuDzp.cjs');
 var require$$0$1 = require('fs');
 var require$$1 = require('path');

package/dist/cli-chunks/{runtime-permission-env-B9SqoP85.cjs → runtime-permission-env-CDx5qO-T.cjs}

@@ -1,9 +1,9 @@
 'use strict';
 
-var index = require('./index-bZIxID9N.cjs');
+var index = require('./index-CY67PpQk.cjs');
 var fs = require('node:fs');
 var path = require('node:path');
-var version$1 = require('./version-CwEOrhL1.cjs');
+var version$1 = require('./version-D40WHkF9.cjs');
 require('node:crypto');
 var node_async_hooks = require('node:async_hooks');
 

package/dist/cli-chunks/{skill-DFXZ0SK_.cjs → skill-Bdy5Ehue.cjs}

@@ -1,10 +1,10 @@
 'use strict';
 
-var version = require('./version-CwEOrhL1.cjs');
+var version = require('./version-D40WHkF9.cjs');
 var fs = require('node:fs/promises');
 var path = require('node:path');
 var childProcess = require('node:child_process');
-var index = require('./index-bZIxID9N.cjs');
+var index = require('./index-CY67PpQk.cjs');
 require('node:module');
 require('readline');
 require('os');

package/dist/cli-chunks/{version-CwEOrhL1.cjs → version-D40WHkF9.cjs}

@@ -3,6 +3,6 @@
 /** 构建时替换为当前发布包的实际版本。 */
 const HB_SDK_VERSION = typeof undefined === 'string'
     ? undefined
-    : '0.9.2-alpha.7';
+    : '0.9.2-alpha.8';
 
 exports.HB_SDK_VERSION = HB_SDK_VERSION;

package/dist/cli.cjs

@@ -1,6 +1,6 @@
 'use strict';
 
-var index = require('./cli-chunks/index-bZIxID9N.cjs');
+var index = require('./cli-chunks/index-CY67PpQk.cjs');
 require('node:module');
 require('readline');
 require('os');