@heybox/hb-sdk 0.4.5 → 0.4.7

package/dist/cli-chunks/{remote-DjaOc1VS.cjs → remote-Cc5j-m2I.cjs}

@@ -1,13 +1,12 @@
 'use strict';
 
 var promises = require('node:readline/promises');
+var session = require('./session-BSi5YfqO.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 session = require('./session-BAgaqpNL.cjs');
-var index = require('./index-BYMTp2I6.cjs');
-var node_crypto = require('node:crypto');
+var index = require('./index-13_8m0Pw.cjs');
 
 var re = {exports: {}};
 
@@ -2859,7 +2858,11 @@ function formatReason(error) {
 
 const MINIAPP_UPLOAD_SCOPE = 'activity';
 const ACTIVITY_UPLOAD_KEY_MAX_LENGTH = 64;
+const MINIAPP_UPLOAD_BATCH_SIZE = 50;
+const MINIAPP_UPLOAD_TOTAL_SIZE_LIMIT_BYTES = 100 * 1024 * 1024;
 const USER_MINIPROGRAM_ACCESS_STATUS_API_PATH = '/mall/developer/user_miniprogram/access_status';
+const DEVELOPER_ENTITY_LIST_API_PATH = '/mall/developer/entity/list';
+const DEVELOPER_ENTITY_SWITCH_API_PATH = '/mall/developer/entity/switch';
 const LIST_USER_MINIPROGRAM_API_PATH = '/mall/developer/user_miniprogram/list';
 const CREATE_USER_MINIPROGRAM_API_PATH = '/mall/developer/user_miniprogram/create';
 const UPDATE_USER_MINIPROGRAM_API_PATH = '/mall/developer/user_miniprogram/update';
@@ -2915,6 +2918,17 @@ function validateUploadPaths(items, options) {
     }
     return undefined;
 }
+function validateUploadTotalSize(items, options = {}) {
+    const limit = options.limitBytes ?? MINIAPP_UPLOAD_TOTAL_SIZE_LIMIT_BYTES;
+    const total = items.reduce((sum, item) => {
+        const size = Number(item.size);
+        return sum + (Number.isFinite(size) && size > 0 ? size : 0);
+    }, 0);
+    if (total > limit) {
+        return '构建产物总大小超过 100MB，请删除未引用资源或压缩图片后重新 deploy';
+    }
+    return undefined;
+}
 function shouldUploadDistFile(relativePath) {
     const normalized = normalizeRelativePath(relativePath);
     if (!normalized) {
@@ -2932,281 +2946,6 @@ function shouldUploadDistFile(relativePath) {
     return true;
 }
 
-const globalHeyboxCliRequestConfig = {};
-function readHeyboxCliRequestConfig() {
-    return normalizeHeyboxRylaiServiceTagConfig(globalHeyboxCliRequestConfig);
-}
-function resolveHeyboxRylaiServiceTag(pathWithQuery, config = readHeyboxCliRequestConfig()) {
-    const normalized = normalizeHeyboxRylaiServiceTagConfig(config);
-    const pathname = pathWithQuery ? getPathname(pathWithQuery) : '';
-    const specialTag = normalized.special_tag;
-    if (pathname && specialTag?.path_prefix_list.some((prefix) => pathname.startsWith(prefix))) {
-        return specialTag.tag_name;
-    }
-    return normalized.default_tag;
-}
-function normalizeHeyboxRylaiServiceTagConfig(config) {
-    const defaultTag = normalizeHeyboxRylaiServiceTag(config.default_tag);
-    const specialTagName = normalizeHeyboxRylaiServiceTag(config.special_tag?.tag_name);
-    const pathPrefixList = config.special_tag?.path_prefix_list?.filter(isValidPathPrefix) || [];
-    return {
-        ...(defaultTag ? { default_tag: defaultTag } : {}),
-        ...(specialTagName && pathPrefixList.length
-            ? {
-                special_tag: {
-                    tag_name: specialTagName,
-                    path_prefix_list: pathPrefixList,
-                },
-            }
-            : {}),
-    };
-}
-function normalizeHeyboxRylaiServiceTag(value) {
-    const tag = String(value ?? '').trim();
-    if (!tag) {
-        return undefined;
-    }
-    if (/[\r\n]/.test(tag)) {
-        throw new Error('x-rylai-service-tag 不允许包含换行符');
-    }
-    return tag;
-}
-function isValidPathPrefix(value) {
-    return typeof value === 'string' && value.startsWith('/') && !/[\r\n]/.test(value);
-}
-function getPathname(pathWithQuery) {
-    try {
-        return new URL(pathWithQuery, 'https://api.xiaoheihe.cn').pathname;
-    }
-    catch {
-        return '';
-    }
-}
-
-const SIGN_VERSION = '999.0.4';
-const SIGN_CHARSET = 'AB45STUVWZEFGJ6CH01D237IXYPQRKLMN89';
-function createHeyboxOpenPlatformSignParams(pathname, options = {}) {
-    const now = options.now ?? new Date();
-    const time = Math.trunc(now.getTime() / 1000);
-    const nonce = options.nonce ?? md5(`${time}${Date.now()}${node_crypto.randomBytes(16).toString('hex')}`).toUpperCase();
-    return {
-        version: SIGN_VERSION,
-        hkey: generateSignature(pathname, time + 1, nonce),
-        _time: time,
-        nonce,
-    };
-}
-function generateSignature(path, time, nonce) {
-    const normalizedPath = `/${path
-        .split('/')
-        .filter(Boolean)
-        .join('/')}/`;
-    const transformedTime = transformWithOffset(String(time), SIGN_CHARSET, -2);
-    const transformedPath = transform(normalizedPath, SIGN_CHARSET);
-    const transformedNonce = transform(nonce, SIGN_CHARSET);
-    const combined = interleave([transformedTime, transformedPath, transformedNonce]).slice(0, 20);
-    const hash = md5(combined);
-    let sign = `${mixColumns(hash.slice(-6).split('').map((char) => char.charCodeAt(0))).reduce((sum, value) => sum + value, 0) % 100}`;
-    sign = sign.length < 2 ? `0${sign}` : sign;
-    return `${transformWithOffset(hash.substring(0, 5), SIGN_CHARSET, -4)}${sign}`;
-}
-function transformWithOffset(str, charset, offset) {
-    return transform(str, charset.slice(0, offset));
-}
-function transform(str, charset) {
-    let output = '';
-    for (let index = 0; index < str.length; index += 1) {
-        output += charset[str.charCodeAt(index) % charset.length];
-    }
-    return output;
-}
-function interleave(strings) {
-    let output = '';
-    const maxLength = Math.max(...strings.map((str) => str.length));
-    for (let index = 0; index < maxLength; index += 1) {
-        for (const str of strings) {
-            if (index < str.length) {
-                output += str[index];
-            }
-        }
-    }
-    return output;
-}
-function mixColumns(column) {
-    const output = [...column];
-    output[0] = multiplyE(column[0]) ^ multiply4(column[1]) ^ multiply3(column[2]) ^ multiply2(column[3]);
-    output[1] = multiply2(column[0]) ^ multiplyE(column[1]) ^ multiply4(column[2]) ^ multiply3(column[3]);
-    output[2] = multiply3(column[0]) ^ multiply2(column[1]) ^ multiplyE(column[2]) ^ multiply4(column[3]);
-    output[3] = multiply4(column[0]) ^ multiply3(column[1]) ^ multiply2(column[2]) ^ multiplyE(column[3]);
-    return output;
-}
-function multiply1(value) {
-    if (value & 0x80) {
-        return ((value << 1) ^ 0x1b) & 0xff;
-    }
-    return value << 1;
-}
-function multiply2(value) {
-    return multiply1(value) ^ value;
-}
-function multiply3(value) {
-    return multiply2(multiply1(value));
-}
-function multiply4(value) {
-    return multiply3(multiply2(multiply1(value)));
-}
-function multiplyE(value) {
-    return multiply4(value) ^ multiply3(value) ^ multiply2(value);
-}
-function md5(input) {
-    return node_crypto.createHash('md5').update(input).digest('hex');
-}
-
-const DEFAULT_PLATFORM_PARAMS = {
-    os_type: 'web',
-    app: 'heybox',
-    x_client_type: 'web',
-    x_os_type: 'Mac',
-    x_app: 'heybox',
-    x_client_version: '999.999.999',
-};
-const HEYBOX_WEB_REFERER = 'https://www.xiaoheihe.cn/';
-function resolveHeyboxId(session) {
-    if (session.heyboxId.trim()) {
-        return session.heyboxId.trim();
-    }
-    return session.cookieHeader
-        .split(';')
-        .map((part) => part.trim())
-        .find((part) => part.startsWith('heybox_id='))
-        ?.slice('heybox_id='.length);
-}
-function createHeyboxAuthHeaders(session, options = {}) {
-    const serviceTag = resolveHeyboxRylaiServiceTag(options.pathWithQuery);
-    return {
-        Cookie: session.cookieHeader,
-        Referer: HEYBOX_WEB_REFERER,
-        ...(options.contentType ? { 'Content-Type': options.contentType } : {}),
-        ...(serviceTag ? { 'x-rylai-service-tag': serviceTag } : {}),
-    };
-}
-function createHeyboxRequestContext(session$1, options = {}) {
-    const heyboxId = resolveHeyboxId(session$1);
-    const serviceTag = resolveHeyboxRylaiServiceTag(options.pathWithQuery);
-    return {
-        baseUrl: session.HEYBOX_API_BASE_URL,
-        headers: createHeyboxAuthHeaders(session$1, options),
-        platformParams: {
-            ...DEFAULT_PLATFORM_PARAMS,
-            ...options.platformParams,
-            ...(heyboxId ? { heybox_id: heyboxId } : {}),
-            ...(serviceTag ? { special_tag: serviceTag } : {}),
-        },
-    };
-}
-function createHeyboxOpenPlatformRequestContext(session, pathWithQuery, options = {}) {
-    return createHeyboxRequestContext(session, {
-        ...options,
-        pathWithQuery,
-        platformParams: {
-            x_app: 'heybox_website',
-            ...createHeyboxOpenPlatformSignParams(getApiPathname(pathWithQuery)),
-            ...options.platformParams,
-        },
-    });
-}
-function createHeyboxApiUrl(baseUrl, pathWithQuery, params) {
-    const url = new URL(pathWithQuery, baseUrl);
-    for (const [key, value] of Object.entries(params)) {
-        if (value !== '') {
-            url.searchParams.set(key, String(value));
-        }
-    }
-    return url.toString();
-}
-function getApiPathname(pathWithQuery) {
-    return new URL(pathWithQuery, session.HEYBOX_API_BASE_URL).pathname;
-}
-const ENVELOPE_BODY_PREVIEW_LENGTH = 1000;
-async function readHeyboxApiEnvelope(response, options) {
-    const rawBody = await response.text();
-    let envelope = null;
-    let parseError = null;
-    if (rawBody) {
-        try {
-            envelope = JSON.parse(rawBody);
-        }
-        catch (error) {
-            parseError = error;
-        }
-    }
-    const envelopeOk = envelope?.status === 'ok' && (!options.requireResult || envelope?.result !== undefined);
-    if (response.ok && envelopeOk) {
-        return envelope.result;
-    }
-    const { message, verboseMessage } = formatHeyboxEnvelopeError({
-        response,
-        envelope,
-        parseError,
-        rawBody,
-        pathWithQuery: options.pathWithQuery,
-    });
-    throw new index.CliError(message, verboseMessage);
-}
-function formatHeyboxEnvelopeError(input) {
-    const parts = [`Heybox API ${input.pathWithQuery} failed`, `HTTP ${input.response.status}`];
-    if (input.envelope) {
-        const msg = typeof input.envelope.msg === 'string' ? input.envelope.msg.trim() : '';
-        const sbeUserMessage = readSbeUserMessage(input.envelope.result);
-        parts.push(`msg=${msg || '(empty)'}`);
-        if (typeof input.envelope.status === 'string') {
-            parts.push(`envelope.status=${input.envelope.status}`);
-        }
-        const { status: _s, msg: _m, result: _r, ...extras } = input.envelope;
-        if (Object.keys(extras).length > 0) {
-            parts.push(`extras=${truncate(safeJsonStringify(extras), ENVELOPE_BODY_PREVIEW_LENGTH)}`);
-        }
-        if (input.envelope.result !== undefined) {
-            parts.push(`result=${truncate(safeJsonStringify(input.envelope.result), ENVELOPE_BODY_PREVIEW_LENGTH)}`);
-        }
-        return {
-            message: sbeUserMessage || msg || `Heybox API ${input.pathWithQuery} 请求失败`,
-            verboseMessage: parts.join(' '),
-        };
-    }
-    if (input.parseError) {
-        const parseMsg = input.parseError instanceof Error ? input.parseError.message : String(input.parseError);
-        parts.push(`parseError=${parseMsg}`);
-    }
-    parts.push(input.rawBody ? `body=${truncate(input.rawBody, ENVELOPE_BODY_PREVIEW_LENGTH)}` : 'body=(empty)');
-    return {
-        message: `Heybox API ${input.pathWithQuery} 请求失败`,
-        verboseMessage: parts.join(' '),
-    };
-}
-function readSbeUserMessage(result) {
-    if (!result || typeof result !== 'object') {
-        return '';
-    }
-    const sbe = result.sbe;
-    if (!sbe || typeof sbe !== 'object') {
-        return '';
-    }
-    const userMessage = sbe.user_message;
-    return typeof userMessage === 'string' ? userMessage.trim() : '';
-}
-function truncate(value, max) {
-    return value.length > max ? `${value.slice(0, max)}...(+${value.length - max} chars)` : value;
-}
-function safeJsonStringify(value) {
-    try {
-        return JSON.stringify(value);
-    }
-    catch {
-        return String(value);
-    }
-}
-
 async function getCDNUploadInfo(options, runtime = {}) {
     const body = new URLSearchParams();
     body.set('file_infos', JSON.stringify(options.fileInfos));
@@ -3228,17 +2967,17 @@ async function postCDNUploadCallback(options, runtime = {}) {
     const query = options.isFinished ? '?is_finished=true' : '';
     return postHeyboxApi(`/bbs/app/api/qcloud/cos/upload/callback/v2${query}`, body, options.session, runtime);
 }
-async function postHeyboxApi(pathWithQuery, body, session, runtime) {
+async function postHeyboxApi(pathWithQuery, body, session$1, runtime) {
     const fetchImpl = runtime.fetchImpl ?? fetch;
-    const context = createHeyboxOpenPlatformRequestContext(session, pathWithQuery, {
+    const context = session.createHeyboxOpenPlatformRequestContext(session$1, pathWithQuery, {
         contentType: 'application/x-www-form-urlencoded',
     });
-    const response = await fetchImpl(createHeyboxApiUrl(runtime.baseUrl ?? context.baseUrl, pathWithQuery, context.platformParams), {
+    const response = await fetchImpl(session.createHeyboxApiUrl(runtime.baseUrl ?? context.baseUrl, pathWithQuery, context.platformParams), {
         method: 'POST',
         headers: context.headers,
         body: body.toString(),
     });
-    const result = await readHeyboxApiEnvelope(response, { pathWithQuery, requireResult: true });
+    const result = await session.readHeyboxApiEnvelope(response, { pathWithQuery, requireResult: true });
     return result;
 }
 
@@ -3252,7 +2991,74 @@ async function runUpload(options, runtime = {}) {
     const postCDNUploadCallback$1 = runtime.postCDNUploadCallback ?? postCDNUploadCallback;
     const createReadStream = runtime.createReadStream ?? fs.createReadStream;
     const orderedFiles = [...options.files].sort((a, b) => a.relativePath.localeCompare(b.relativePath));
-    const fileInfos = orderedFiles.map((file) => ({
+    const batches = chunkUploadFiles(orderedFiles, MINIAPP_UPLOAD_BATCH_SIZE);
+    await logger.task(`正在上传 ${orderedFiles.length} 个文件`, async (taskContext) => {
+        logger.debug(`上传并发数: ${concurrency}`);
+        logger.debug(`上传批次数: ${batches.length}`);
+        let completed = 0;
+        for (let batchIndex = 0; batchIndex < batches.length; batchIndex += 1) {
+            const batch = batches[batchIndex];
+            logger.debug(`正在处理上传批次 ${batchIndex + 1}/${batches.length}，文件数: ${batch.length}`);
+            logger.debug('正在获取 CDN 上传信息');
+            const fileInfos = createUploadFileInfos(batch, options);
+            const uploadInfo = await getCDNUploadInfo$1({ session: options.session, scope: MINIAPP_UPLOAD_SCOPE, fileInfos, needCache: false }, { baseUrl: runtime.baseUrl, fetchImpl });
+            logger.debug(`CDN bucket: ${uploadInfo.bucket}`);
+            logger.debug(`CDN region: ${uploadInfo.region}`);
+            validateUploadInfoKeys(batch, uploadInfo.keys, options);
+            const indexedFiles = batch.map((file, index) => ({ file, key: uploadInfo.keys[index] }));
+            const batchKeys = indexedFiles.map(({ key }) => key);
+            logger.debug('正在获取 CDN 上传凭证');
+            const uploadToken = await getCDNUploadToken$1({
+                session: options.session,
+                bucket: uploadInfo.bucket,
+                keys: batchKeys,
+                mimetypes: indexedFiles.map(({ file }) => file.mimeType),
+                isMultipartUpload: 0,
+            }, { baseUrl: runtime.baseUrl, fetchImpl });
+            const cos = runtime.createCosClient ? runtime.createCosClient({ session: options.session, uploadToken }) : await createDefaultCosClient(uploadToken);
+            const queue = indexedFiles.slice();
+            const workers = Array.from({ length: Math.min(concurrency, indexedFiles.length) }, async () => {
+                while (queue.length > 0) {
+                    const uploadTask = queue.shift();
+                    if (!uploadTask) {
+                        return;
+                    }
+                    try {
+                        await cos.putObject({
+                            Bucket: uploadInfo.bucket,
+                            Region: uploadInfo.region,
+                            Key: uploadTask.key,
+                            Body: createReadStream(uploadTask.file.absolutePath),
+                            ContentLength: uploadTask.file.size,
+                            ContentType: uploadTask.file.mimeType,
+                        });
+                        completed += 1;
+                        taskContext.update(`正在上传 ${completed}/${orderedFiles.length} 个文件`);
+                        logger.debug(`[${String(completed).padStart(2)}/${orderedFiles.length}] ok ${uploadTask.file.relativePath} (${formatSize(uploadTask.file.size)})`);
+                    }
+                    catch (error) {
+                        completed += 1;
+                        const message = readErrorMessage(error);
+                        logger.debug(`[${String(completed).padStart(2)}/${orderedFiles.length}] error ${uploadTask.file.relativePath} -> ${message}`);
+                        throw new index.CliError(`上传文件失败：${uploadTask.file.relativePath} -> ${message}`, readVerboseUploadError(uploadTask.file.relativePath, error));
+                    }
+                }
+            });
+            await Promise.all(workers);
+            logger.debug('正在确认 CDN 上传结果');
+            await postCDNUploadCallback$1({ session: options.session, keys: batchKeys, isFinished: true }, { baseUrl: runtime.baseUrl, fetchImpl });
+        }
+    }, { successText: `已上传 ${orderedFiles.length} 个文件` });
+}
+function chunkUploadFiles(files, batchSize) {
+    const batches = [];
+    for (let index = 0; index < files.length; index += batchSize) {
+        batches.push(files.slice(index, index + batchSize));
+    }
+    return batches;
+}
+function createUploadFileInfos(files, options) {
+    return files.map((file) => ({
         name: file.relativePath.split('/').pop() ?? file.relativePath,
         mimetype: file.mimeType,
         fsize: file.size,
@@ -3262,56 +3068,22 @@ async function runUpload(options, runtime = {}) {
             relativePath: file.relativePath,
         }),
     }));
-    await logger.task(`正在上传 ${orderedFiles.length} 个文件`, async (taskContext) => {
-        logger.debug(`上传并发数: ${concurrency}`);
-        logger.debug('正在获取 CDN 上传信息');
-        const uploadInfo = await getCDNUploadInfo$1({ session: options.session, scope: MINIAPP_UPLOAD_SCOPE, fileInfos, needCache: false }, { baseUrl: runtime.baseUrl, fetchImpl });
-        logger.debug(`CDN bucket: ${uploadInfo.bucket}`);
-        logger.debug(`CDN region: ${uploadInfo.region}`);
-        const indexedFiles = orderedFiles.map((file, index) => ({ file, key: uploadInfo.keys[index] }));
-        logger.debug('正在获取 CDN 上传凭证');
-        const cos = runtime.createCosClient
-            ? runtime.createCosClient({ session: options.session })
-            : await createDefaultCosClient(await getCDNUploadToken$1({
-                session: options.session,
-                bucket: uploadInfo.bucket,
-                keys: indexedFiles.map(({ key }) => key),
-                mimetypes: indexedFiles.map(({ file }) => file.mimeType),
-                isMultipartUpload: 0,
-            }, { baseUrl: runtime.baseUrl, fetchImpl }));
-        const queue = indexedFiles.slice();
-        let completed = 0;
-        const workers = Array.from({ length: Math.min(concurrency, indexedFiles.length) }, async () => {
-            while (queue.length > 0) {
-                const uploadTask = queue.shift();
-                if (!uploadTask) {
-                    return;
-                }
-                try {
-                    await cos.putObject({
-                        Bucket: uploadInfo.bucket,
-                        Region: uploadInfo.region,
-                        Key: uploadTask.key,
-                        Body: createReadStream(uploadTask.file.absolutePath),
-                        ContentLength: uploadTask.file.size,
-                        ContentType: uploadTask.file.mimeType,
-                    });
-                    completed += 1;
-                    taskContext.update(`正在上传 ${completed}/${indexedFiles.length} 个文件`);
-                    logger.debug(`[${String(completed).padStart(2)}/${indexedFiles.length}] ok ${uploadTask.file.relativePath} (${formatSize(uploadTask.file.size)})`);
-                }
-                catch (error) {
-                    completed += 1;
-                    const message = readErrorMessage(error);
-                    logger.debug(`[${String(completed).padStart(2)}/${indexedFiles.length}] error ${uploadTask.file.relativePath} -> ${message}`);
-                    throw new index.CliError(`上传文件失败：${uploadTask.file.relativePath} -> ${message}`, readVerboseUploadError(uploadTask.file.relativePath, error));
-                }
-            }
+}
+function validateUploadInfoKeys(files, keys, options) {
+    if (keys.length !== files.length) {
+        throw new index.CliError(`CDN 上传接口返回 key 数量异常：期望 ${files.length}，实际 ${keys.length}`);
+    }
+    for (let index$1 = 0; index$1 < files.length; index$1 += 1) {
+        const expectedKey = getMiniappUploadKey({
+            miniProgramId: options.miniProgramId,
+            version: options.version,
+            relativePath: files[index$1].relativePath,
         });
-        await Promise.all(workers);
-        logger.debug('正在确认 CDN 上传结果');
-        await postCDNUploadCallback$1({ session: options.session, keys: uploadInfo.keys, isFinished: true }, { baseUrl: runtime.baseUrl, fetchImpl });
-    }, { successText: `已上传 ${orderedFiles.length} 个文件` });
+        const actualKey = keys[index$1];
+        if (actualKey !== expectedKey) {
+            throw new index.CliError(`CDN 上传接口返回 key 异常：${files[index$1].relativePath}`, [`CDN 上传接口返回 key 异常：${files[index$1].relativePath}`, `expected: ${expectedKey}`, `actual: ${actualKey}`].join('\n'));
+        }
+    }
 }
 async function createDefaultCosClient(uploadToken) {
     const COS = await loadCosConstructor();
@@ -3341,7 +3113,7 @@ async function createDefaultCosClient(uploadToken) {
     };
 }
 async function loadCosConstructor() {
-    const cosModule = await Promise.resolve().then(function () { return require('./index-DRsyeAcg.cjs'); }).then(function (n) { return n.index; });
+    const cosModule = await Promise.resolve().then(function () { return require('./index-2nlBRew_.cjs'); }).then(function (n) { return n.index; });
     return cosModule.default;
 }
 function formatSize(bytes) {
@@ -3400,7 +3172,7 @@ async function submitUserMiniprogramAudit$1(options, runtime = {}) {
 }
 async function postUserMiniprogramVersionForm(path, options, fields, runtime) {
     const fetchImpl = runtime.fetchImpl ?? fetch;
-    const context = createHeyboxOpenPlatformRequestContext(options.session, path, {
+    const context = session.createHeyboxOpenPlatformRequestContext(options.session, path, {
         contentType: 'application/x-www-form-urlencoded',
     });
     const body = new URLSearchParams();
@@ -3408,12 +3180,12 @@ async function postUserMiniprogramVersionForm(path, options, fields, runtime) {
     for (const [key, value] of Object.entries(fields)) {
         body.set(key, value);
     }
-    const response = await fetchImpl(createHeyboxApiUrl(runtime.baseUrl ?? context.baseUrl, path, context.platformParams), {
+    const response = await fetchImpl(session.createHeyboxApiUrl(runtime.baseUrl ?? context.baseUrl, path, context.platformParams), {
         method: 'POST',
         headers: context.headers,
         body: body.toString(),
     });
-    const result = await readHeyboxApiEnvelope(response, {
+    const result = await session.readHeyboxApiEnvelope(response, {
         pathWithQuery: path,
     });
     return result ?? {};
@@ -3507,6 +3279,10 @@ async function runDeployCommand(options, runtime = {}) {
         if (pathError) {
             throw new Error(pathError);
         }
+        const sizeError = validateUploadTotalSize(files);
+        if (sizeError) {
+            throw new Error(sizeError);
+        }
         logger.debug(`待上传文件数: ${files.length}`);
         return files;
     }, { successText: 'dist 上传文件校验完成' });
@@ -3523,12 +3299,12 @@ async function runDeployCommand(options, runtime = {}) {
     catch (error) {
         throw translateHeyboxDeployError(error, { projectRoot, stage: 'submitAudit', version });
     }
-    printDeploySuccess({ autoPublish, logger, miniProgramId, mode: options.successOutputMode ?? 'legacy', previewUrl: submitAuditResult.preview_url, version });
+    printDeploySuccess({ autoPublish, logger, miniProgramId, mode: options.successOutputMode ?? 'legacy', protocolString: submitAuditResult.protocol_string, version });
     return {
         autoPublish,
         changed: true,
         miniProgramId,
-        ...(submitAuditResult.preview_url ? { previewUrl: submitAuditResult.preview_url } : {}),
+        ...(submitAuditResult.protocol_string ? { protocolString: submitAuditResult.protocol_string } : {}),
         version,
     };
 }
@@ -3536,8 +3312,8 @@ function printDeploySuccess(options) {
     options.logger.success(`提交审核成功：${options.miniProgramId} ${options.version}`);
     if (options.mode === 'remote') {
         options.logger.info(`发布策略：${options.autoPublish ? '审核通过后自动发布' : '审核通过后需手动发布'}`);
-        if (options.previewUrl) {
-            options.logger.info(`Preview URL: ${options.previewUrl}`);
+        if (options.protocolString) {
+            options.logger.info(`Protocol: ${options.protocolString}`);
             options.logger.info('允许他人预览：hb-sdk remote allowlist add <heybox_id>');
         }
         options.logger.info(options.autoPublish
@@ -3546,8 +3322,8 @@ function printDeploySuccess(options) {
         return;
     }
     options.logger.info(`发布策略：${options.autoPublish ? '审核通过后自动发布' : '审核通过后需在开放平台手动发布'}`);
-    if (options.previewUrl) {
-        options.logger.info(`Preview URL: ${options.previewUrl}`);
+    if (options.protocolString) {
+        options.logger.info(`Protocol: ${options.protocolString}`);
     }
 }
 function findProjectRoot(startDir) {
@@ -3764,6 +3540,8 @@ function suggestNextPatchVersion(version) {
 
 function createRemoteApiClient(options) {
     return {
+        listDeveloperEntities: () => listDeveloperEntities(options),
+        switchDeveloperEntity: (requestOptions) => switchDeveloperEntity(requestOptions, options),
         getDeveloperAccessStatus: () => getDeveloperAccessStatus(options),
         listUserMiniprograms: (requestOptions = {}) => listUserMiniprograms(requestOptions, options),
         createUserMiniprogram: (requestOptions) => createUserMiniprogram(requestOptions, options),
@@ -3781,6 +3559,12 @@ function createRemoteApiClient(options) {
         listUserMiniprogramVersions: (requestOptions) => listUserMiniprogramVersions(requestOptions, options),
     };
 }
+async function listDeveloperEntities(runtime) {
+    return remoteGet(DEVELOPER_ENTITY_LIST_API_PATH, {}, runtime);
+}
+async function switchDeveloperEntity(options, runtime) {
+    return (await remotePostForm(DEVELOPER_ENTITY_SWITCH_API_PATH, options, runtime, { requireResult: false })) ?? {};
+}
 async function getDeveloperAccessStatus(runtime) {
     return remoteGet(USER_MINIPROGRAM_ACCESS_STATUS_API_PATH, {}, runtime);
 }
@@ -3831,30 +3615,36 @@ async function listUserMiniprogramVersions(options, runtime) {
 }
 async function remoteGet(path, query, runtime) {
     const pathWithQuery = createPathWithQuery(path, query);
-    const context = createHeyboxOpenPlatformRequestContext(runtime.session, pathWithQuery);
+    const context = session.createHeyboxOpenPlatformRequestContext(runtime.session, pathWithQuery);
     const fetchImpl = runtime.fetchImpl ?? fetch;
-    const response = await fetchImpl(createHeyboxApiUrl(runtime.baseUrl ?? context.baseUrl, pathWithQuery, context.platformParams), {
+    const response = await fetchImpl(session.createHeyboxApiUrl(runtime.baseUrl ?? context.baseUrl, pathWithQuery, context.platformParams), {
         method: 'GET',
         headers: context.headers,
     });
     return readRequiredResult(response, pathWithQuery);
 }
-async function remotePostForm(path, fields, runtime) {
-    const context = createHeyboxOpenPlatformRequestContext(runtime.session, path, {
+async function remotePostForm(path, fields, runtime, options = {}) {
+    const context = session.createHeyboxOpenPlatformRequestContext(runtime.session, path, {
         contentType: 'application/x-www-form-urlencoded',
     });
     const fetchImpl = runtime.fetchImpl ?? fetch;
-    const response = await fetchImpl(createHeyboxApiUrl(runtime.baseUrl ?? context.baseUrl, path, context.platformParams), {
+    const response = await fetchImpl(session.createHeyboxApiUrl(runtime.baseUrl ?? context.baseUrl, path, context.platformParams), {
         method: 'POST',
         headers: context.headers,
         body: createFormBody(fields),
     });
+    if (options.requireResult === false) {
+        return readOptionalResult(response, path);
+    }
     return readRequiredResult(response, path);
 }
 async function readRequiredResult(response, pathWithQuery) {
-    const result = await readHeyboxApiEnvelope(response, { pathWithQuery, requireResult: true });
+    const result = await session.readHeyboxApiEnvelope(response, { pathWithQuery, requireResult: true });
     return result;
 }
+async function readOptionalResult(response, pathWithQuery) {
+    return session.readHeyboxApiEnvelope(response, { pathWithQuery, requireResult: false });
+}
 function createPathWithQuery(path, query) {
     const params = new URLSearchParams();
     for (const [key, value] of Object.entries(query)) {
@@ -4004,6 +3794,12 @@ async function runRemoteCommand(options, runtime = {}) {
     switch (options.command) {
         case 'access':
             return remoteAccess(options, context, runtime);
+        case 'entity:list':
+            return remoteEntityList(options, context, runtime);
+        case 'entity:current':
+            return remoteEntityCurrent(options, context, runtime);
+        case 'entity:switch':
+            return remoteEntitySwitch(options, context, runtime);
         case 'list':
             return remoteList(options, context, runtime);
         case 'create':
@@ -4035,6 +3831,9 @@ async function runRemoteCommand(options, runtime = {}) {
 }
 async function runRemoteDeployCommand(options, runtime) {
     const logger = resolveRemoteLogger(options, runtime);
+    const context = await createRemoteCommandContext(options, runtime);
+    const miniProgramId = requireBinding(context);
+    await assertBoundMiniProgramEntityMatchesCurrent(context, miniProgramId);
     const deployRuntime = {
         cwd: runtime.cwd,
         fetchImpl: runtime.fetchImpl,
@@ -4091,14 +3890,16 @@ async function createRemoteCommandContext(options, runtime) {
 function adaptRemoteApiClient(api) {
     return {
         accessStatus: () => api.getDeveloperAccessStatus(),
-        listMiniPrograms: ({ keyword, status }) => api.listUserMiniprograms({ keyword, status, offset: 0, limit: 200 }),
+        listMiniPrograms: ({ keyword, limit = 200, offset = 0, status }) => api.listUserMiniprograms({ keyword, status, offset, limit }),
         createMiniProgram: ({ name, previewImageUrl }) => api.createUserMiniprogram({ name, ...(previewImageUrl ? { preview_image_url: previewImageUrl } : {}) }),
         updateMiniProgram: ({ miniProgramId, name, previewImageUrl }) => api.updateUserMiniprogram({ mini_program_id: miniProgramId, name, preview_image_url: previewImageUrl }),
         getMiniProgramDetail: (miniProgramId) => api.getUserMiniprogramDetail({ mini_program_id: miniProgramId }),
         getAllowlist: (miniProgramId) => api.getPreviewAllowlist({ mini_program_id: miniProgramId }),
         updateAllowlist: ({ miniProgramId, heyboxIds }) => api.updatePreviewAllowlist({ mini_program_id: miniProgramId, heybox_ids: heyboxIds }),
         listVersions: (miniProgramId) => api.listUserMiniprogramVersions({ mini_program_id: miniProgramId, offset: 0, limit: 50 }),
-        getPreviewInfo: ({ miniProgramId, version }) => api.getVersionPreviewInfo({ mini_program_id: miniProgramId, preview_version: version }),
+        getPreviewInfo: ({ miniProgramId, version }) => api.getVersionPreviewInfo({ mini_program_id: miniProgramId, version }),
+        listDeveloperEntities: () => api.listDeveloperEntities(),
+        switchDeveloperEntity: ({ entityId }) => api.switchDeveloperEntity({ entity_id: entityId }),
         releaseVersion: ({ miniProgramId, version }) => api.releaseUserMiniprogramVersion({ mini_program_id: miniProgramId, version }),
         withdrawVersion: ({ miniProgramId, reason, version }) => api.withdrawUserMiniprogramVersion({ mini_program_id: miniProgramId, version, reason }),
         takeDown: (miniProgramId) => api.takeDownUserMiniprogram({ mini_program_id: miniProgramId }),
@@ -4119,6 +3920,66 @@ async function remoteAccess(options, context, runtime) {
     }
     return finishRemoteCommand(options, runtime, output);
 }
+async function remoteEntityList(options, context, runtime) {
+    const result = await listDeveloperEntitiesWithAccessFallback(context);
+    const items = result.items;
+    const output = { changed: false, items: toCamelCaseDeep(items), total: result.total };
+    if (!options.json) {
+        if (items.length === 0) {
+            context.logger.info('当前账号未绑定开发者主体');
+        }
+        else {
+            printDeveloperEntities(context.logger, items);
+        }
+    }
+    return finishRemoteCommand(options, runtime, output);
+}
+async function remoteEntityCurrent(options, context, runtime) {
+    const current = await requireCurrentDeveloperEntity(context);
+    const access = await context.api.accessStatus();
+    const output = { changed: false, current: toCamelCaseDeep(current), access: toCamelCaseDeep(access) };
+    if (!options.json) {
+        printDeveloperEntity(context.logger, current, '* ');
+        context.logger.info(`Access status: ${String(access.status ?? 'unknown')}`);
+        if (access.disabled_reason) {
+            context.logger.warn(`Disabled reason: ${String(access.disabled_reason)}`);
+        }
+    }
+    return finishRemoteCommand(options, runtime, output);
+}
+async function remoteEntitySwitch(options, context, runtime) {
+    const entityId = parseEntityId(options.entityId);
+    const entityList = await listDeveloperEntitiesWithAccessFallback(context);
+    const entities = entityList.items;
+    const target = entities.find((entity) => entity.entity_id === entityId);
+    if (!target) {
+        throw new Error(`当前账号不可切换到开发者主体 ${entityId}；请先运行 hb-sdk remote entity list 查看可用主体`);
+    }
+    const result = entityList.fromAccessFallback === true && target.is_current === true ? target : await context.api.switchDeveloperEntity({ entityId });
+    const access = await context.api.accessStatus();
+    const switched = normalizeDeveloperEntity(result) ?? { ...target, is_current: true };
+    const switchedEntityId = normalizeEntityId(switched.entity_id);
+    if (switchedEntityId === undefined) {
+        throw new Error('远端响应缺少 entity_id');
+    }
+    const switchedOwnerHeyboxId = normalizePositiveInteger(switched.owner_heybox_id);
+    await session.setSelectedDeveloperEntitySnapshot({
+        entityId: switchedEntityId,
+        entityName: switched.entity_name || '--',
+        ...(switchedOwnerHeyboxId !== undefined ? { ownerHeyboxId: switchedOwnerHeyboxId } : {}),
+    }, {
+        cacheFile: options.cacheFile,
+        env: options.env,
+        loginBaseUrl: options.loginBaseUrl,
+        now: options.now,
+    });
+    const output = { changed: true, current: toCamelCaseDeep(switched), access: toCamelCaseDeep(access) };
+    if (!options.json) {
+        context.logger.success(`已切换开发者主体：${formatDeveloperEntity(switched)}`);
+        context.logger.info(`Access status: ${String(access.status ?? 'unknown')}`);
+    }
+    return finishRemoteCommand(options, runtime, output);
+}
 async function remoteList(options, context, runtime) {
     const result = await context.api.listMiniPrograms({ keyword: options.keyword, status: options.status });
     const items = Array.isArray(result.items) ? result.items : [];
@@ -4150,6 +4011,7 @@ async function remoteCreate(options, context, runtime) {
     if (access.status !== 'approved') {
         throw new Error(`当前 CLI 用户没有创建开发者用户小程序权限：${String(access.status ?? 'unknown')}`);
     }
+    await confirmCreateWithCurrentEntity(options, context, runtime);
     const result = await context.api.createMiniProgram({ name, previewImageUrl });
     const miniProgramId = requireMiniProgramId(result);
     await writeBoundMiniProgramId(context.packageJson.projectRoot, miniProgramId, { force: options.forceBind });
@@ -4166,6 +4028,7 @@ async function remoteBind(options, context, runtime) {
     }
     const detail = await context.api.getMiniProgramDetail(miniProgramId);
     const verifiedId = requireMiniProgramId(detail);
+    await assertMiniProgramEntityMatchesCurrent(context, detail);
     const changed = context.binding !== verifiedId;
     if (changed) {
         await writeBoundMiniProgramId(context.packageJson.projectRoot, verifiedId, { force: options.force });
@@ -4243,7 +4106,7 @@ async function remoteVersions(options, context, runtime) {
     const output = { changed: false, items: toCamelCaseDeep(items), miniProgramId, total: readNumber(result.total, items.length) };
     if (!options.json) {
         for (const item of items) {
-            context.logger.info(`${item.version ?? '--'}  status=${item.status ?? '--'}  preview=${item.preview_url ?? '--'}  publish=${item.publish_url ?? '--'}`);
+            context.logger.info(`${item.version ?? '--'}  status=${item.status ?? '--'}  auto_publish=${item.auto_publish === true ? 'yes' : 'no'}`);
         }
         if (items.length === 0) {
             context.logger.info('暂无远端版本');
@@ -4255,10 +4118,13 @@ async function remotePreview(options, context, runtime) {
     const miniProgramId = requireBinding(context);
     const version = requireNonEmpty(options.version, 'remote preview 必须传 <version>');
     const result = await context.api.getPreviewInfo({ miniProgramId, version });
-    const previewUrl = String(result.preview_url || result.publish_url || result.page_url || '');
-    const output = { changed: false, miniProgramId, previewUrl, version, preview: toCamelCaseDeep(result) };
+    const protocolString = String(result.protocol_string || '');
+    if (!protocolString) {
+        throw new Error(`版本 ${version} 暂无 protocol_string，无法打开预览`);
+    }
+    const output = { changed: false, miniProgramId, protocolString, version, preview: toCamelCaseDeep(result) };
     if (!options.json) {
-        context.logger.info(previewUrl ? `Preview URL: ${previewUrl}` : `版本 ${version} 暂无 preview URL`);
+        context.logger.info(`Protocol: ${protocolString}`);
     }
     return finishRemoteCommand(options, runtime, output);
 }
@@ -4332,6 +4198,89 @@ function requireBinding(context) {
     }
     return context.binding;
 }
+async function requireCurrentDeveloperEntity(context) {
+    const entities = (await listDeveloperEntitiesWithAccessFallback(context)).items;
+    const current = entities.find((entity) => entity.is_current === true);
+    if (!current) {
+        throw new Error('当前账号没有服务端 current 开发者主体；请先运行 hb-sdk remote entity list 查看可用主体，并用 hb-sdk remote entity switch <entity-id> 切换');
+    }
+    return current;
+}
+async function confirmCreateWithCurrentEntity(options, context, runtime) {
+    const entities = (await listDeveloperEntitiesWithAccessFallback(context)).items;
+    if (entities.length <= 1) {
+        return;
+    }
+    const current = entities.find((entity) => entity.is_current === true);
+    if (!current) {
+        throw new Error('当前账号存在多个开发者主体，但没有服务端 current 主体；请先运行 hb-sdk remote entity switch <entity-id>');
+    }
+    if (!options.json) {
+        context.logger.info(`当前创建将归属开发者主体：${formatDeveloperEntity(current)}`);
+        context.logger.info(`如需切换主体，请先运行：hb-sdk remote entity switch <entity-id>`);
+    }
+    if (options.yes) {
+        return;
+    }
+    const isTTY = runtime.isTTY ?? Boolean(process.stdin.isTTY && process.stderr.isTTY);
+    if (!isTTY) {
+        throw new Error(`当前账号存在多个开发者主体，非交互环境执行 hb-sdk remote create 必须传 --yes 确认使用当前主体：${formatDeveloperEntity(current)}。如需切换，请先运行 hb-sdk remote entity switch <entity-id>`);
+    }
+    const accepted = runtime.promptConfirm
+        ? await runtime.promptConfirm(`确认使用当前开发者主体 ${formatDeveloperEntity(current)} 创建小程序？`)
+        : await promptConfirm(`确认使用当前开发者主体 ${formatDeveloperEntity(current)} 创建小程序？输入 yes 继续: `, runtime);
+    if (!accepted) {
+        throw new Error('已取消操作');
+    }
+}
+async function assertMiniProgramEntityMatchesCurrent(context, detail) {
+    const detailEntityId = normalizeEntityId(detail.entity_id);
+    if (detailEntityId === undefined) {
+        return;
+    }
+    const current = await requireCurrentDeveloperEntity(context);
+    if (current.entity_id === detailEntityId) {
+        return;
+    }
+    throw new Error(createEntityMismatchMessage({ current, target: createEntityFromMiniProgramDetail({ ...detail, entity_id: detailEntityId }) }));
+}
+async function assertBoundMiniProgramEntityMatchesCurrent(context, miniProgramId) {
+    const current = await requireCurrentDeveloperEntity(context);
+    const detail = await context.api.getMiniProgramDetail(miniProgramId);
+    requireMiniProgramId(detail);
+    const detailEntityId = normalizeEntityId(detail.entity_id);
+    if (detailEntityId === undefined) {
+        const listed = await findMiniProgramInCurrentEntityList(context, miniProgramId);
+        if (listed) {
+            return;
+        }
+        throw new Error(`远端小程序 ${miniProgramId} 详情缺少 entity_id，且当前主体列表中找不到该小程序，无法校验当前主体一致性，已停止 deploy`);
+    }
+    if (current.entity_id !== detailEntityId) {
+        throw new Error(createEntityMismatchMessage({ current, target: createEntityFromMiniProgramDetail({ ...detail, entity_id: detailEntityId }) }));
+    }
+}
+async function findMiniProgramInCurrentEntityList(context, miniProgramId) {
+    const pageSize = 200;
+    for (let offset = 0;; offset += pageSize) {
+        const result = await context.api.listMiniPrograms({ limit: pageSize, offset });
+        const items = Array.isArray(result.items) ? result.items : [];
+        if (items.some((item) => item.mini_program_id === miniProgramId)) {
+            return true;
+        }
+        if (items.length < pageSize || offset + items.length >= readNumber(result.total, Number.POSITIVE_INFINITY)) {
+            return false;
+        }
+    }
+}
+function createEntityMismatchMessage(options) {
+    return [
+        '当前开发者主体与远端小程序所属主体不一致，已停止操作。',
+        `当前主体：${formatDeveloperEntity(options.current)}`,
+        `小程序所属主体：${formatDeveloperEntity(options.target)}`,
+        `请先运行：hb-sdk remote entity switch ${options.target.entity_id}`,
+    ].join('\n');
+}
 function requireMiniProgramId(result) {
     const miniProgramId = result.mini_program_id;
     if (typeof miniProgramId !== 'string' || !miniProgramId.trim()) {
@@ -4339,6 +4288,88 @@ function requireMiniProgramId(result) {
     }
     return miniProgramId.trim();
 }
+function parseEntityId(value) {
+    const raw = requireNonEmpty(value, 'remote entity switch 必须传 <entity-id>');
+    if (!/^(0|[1-9]\d*)$/.test(raw)) {
+        throw new Error(`entity-id 只接受十进制数字：${raw}`);
+    }
+    const entityId = Number(raw);
+    if (!isValidEntityId(entityId)) {
+        throw new Error(`entity-id 超出有效范围：${raw}`);
+    }
+    return entityId;
+}
+async function listDeveloperEntitiesWithAccessFallback(context) {
+    const result = await context.api.listDeveloperEntities();
+    const items = normalizeDeveloperEntities(result);
+    if (items.length > 0) {
+        return { items, total: readNumber(result.total, items.length) };
+    }
+    const fallback = createEntityFromAccessStatus(await context.api.accessStatus());
+    if (!fallback) {
+        return { items, total: readNumber(result.total, items.length) };
+    }
+    return { fromAccessFallback: true, items: [fallback], total: 1 };
+}
+function normalizeDeveloperEntities(result) {
+    const rawItems = Array.isArray(result.items) ? result.items : [];
+    return rawItems.map((item) => normalizeDeveloperEntity(item)).filter((item) => item !== undefined);
+}
+function normalizeDeveloperEntity(value) {
+    if (!value || typeof value !== 'object') {
+        return undefined;
+    }
+    const entityId = normalizeEntityId(value.entity_id);
+    if (entityId === undefined) {
+        return undefined;
+    }
+    const ownerHeyboxId = normalizePositiveInteger(value.owner_heybox_id);
+    return {
+        ...value,
+        entity_id: entityId,
+        entity_name: typeof value.entity_name === 'string' ? value.entity_name : undefined,
+        owner_heybox_id: ownerHeyboxId,
+        is_current: value.is_current === true,
+    };
+}
+function createEntityFromMiniProgramDetail(detail) {
+    const entityId = normalizeEntityId(detail.entity_id);
+    return {
+        ...(entityId !== undefined ? { entity_id: entityId } : {}),
+        entity_name: typeof detail.developer_name === 'string' ? detail.developer_name : undefined,
+        owner_heybox_id: normalizePositiveInteger(detail.owner_heybox_id),
+        is_current: false,
+    };
+}
+function createEntityFromAccessStatus(access) {
+    const entity = normalizeDeveloperEntity({
+        entity_id: access.entity_id,
+        entity_name: access.developer_name,
+        owner_heybox_id: access.owner_heybox_id,
+        is_current: true,
+    });
+    return entity;
+}
+function isValidEntityId(value) {
+    return Number.isSafeInteger(value) && Number(value) > 0;
+}
+function normalizeEntityId(value) {
+    return normalizePositiveInteger(value);
+}
+function normalizePositiveInteger(value) {
+    if (typeof value === 'number') {
+        return isValidEntityId(value) ? value : undefined;
+    }
+    if (typeof value !== 'string') {
+        return undefined;
+    }
+    const normalized = value.trim();
+    if (!/^[1-9]\d*$/.test(normalized)) {
+        return undefined;
+    }
+    const parsed = Number(normalized);
+    return isValidEntityId(parsed) ? parsed : undefined;
+}
 function requireNonEmpty(value, message) {
     const normalized = typeof value === 'string' ? value.trim() : '';
     if (!normalized) {
@@ -4462,10 +4493,26 @@ function printMiniProgramDetail(logger, detail) {
     logger.info(`Name: ${detail.name ?? '--'}`);
     logger.info(`Status: ${detail.status ?? '--'}`);
     logger.info(`Version: ${detail.version || detail.latest_version_status || '--'}`);
-    if (detail.publish_url) {
-        logger.info(`Publish URL: ${detail.publish_url}`);
+    if (detail.page_url) {
+        logger.info(`Page URL: ${detail.page_url}`);
+    }
+    if (detail.protocol_string) {
+        logger.info(`Protocol: ${detail.protocol_string}`);
+    }
+}
+function printDeveloperEntities(logger, entities) {
+    for (const entity of entities) {
+        printDeveloperEntity(logger, entity, entity.is_current ? '* ' : '  ');
     }
 }
+function printDeveloperEntity(logger, entity, marker = '') {
+    logger.info(`${marker}${formatDeveloperEntity(entity)}${entity.is_current ? '  current' : ''}`);
+}
+function formatDeveloperEntity(entity) {
+    const name = entity.entity_name || '--';
+    const owner = entity.owner_heybox_id ? `  owner=${entity.owner_heybox_id}` : '';
+    return `${entity.entity_id ?? '--'}  ${name}${owner}`;
+}
 function printAllowlist(logger, result) {
     const items = Array.isArray(result.items) ? result.items : [];
     logger.info(`Limit: ${readNumber(result.limit, 0)}`);